ECMAScript 2021 引入的 Temporal API-JavaScript中文网-JavaScript教程资源分享门户

ECMAScript 2021 引入的 Temporal API 是一个新的时间和日期 API。它包含了一些新的类和方法，用于处理日期、时间、时间段和时区等问题，弥补了 JavaScript 中原本存在的一些问题。

在这篇文章中，我们将详细介绍 Temporal API 的结构和功能，并提供一些示例代码和指导意义，以此帮助读者更好地理解和应用这个新的 API。

Temporal 类和方法

Temporal API 包含了三个主要的类：Temporal.Instant、Temporal.ZonedDateTime 和 Temporal.Duration。下面是每个类的详细解释：

`Temporal.Instant`

Temporal.Instant 表示从纪元开始的一段时间，以及当前的实例，可以使用现代 UTC 时间测量。它是不依赖于时区的，通常用于计算两个事件之间的时间间隔，或者在纪元之后的某一时刻比较两个日期。

下面是 Temporal.Instant 的一些方法：

fromEpochSeconds()：创建一个新的 Temporal.Instant 实例，以从 Unix 纪元时间开始的秒数为参数。
fromEpochMilliseconds()：创建一个新的 Temporal.Instant 实例，以从 Unix 纪元时间开始的毫秒数为参数。
compare()：比较两个 Temporal.Instant 实例之间的时间，返回一个数字。

下面是一个示例代码：

const now = Temporal.Instant.now();
const other = Temporal.Instant.fromEpochSeconds(1234567890);
const diff = now.subtract(other);
console.log(`Difference between now and 1234567890 seconds after Unix epoch: ${diff.total({ units: ['seconds'] })} seconds`);

`Temporal.ZonedDateTime`

Temporal.ZonedDateTime 表示具有时区信息的日期时间。它包含了一个标准的日期时间和一个与之相关联的时区。使用 Temporal.ZonedDateTime，我们可以跨越不同的时区计算出不同时区中的同一个时间点。

下面是一些 Temporal.ZonedDateTime 的方法：

from()：使用一个 Temporal.Instant 和一个时区字符串参数创建一个新的 Temporal.ZonedDateTime 实例。
fromDateAndTime()：使用一个 Temporal.PlainDate 和一个 Temporal.PlainTime 实例创建一个新的 Temporal.ZonedDateTime 实例。
toInstant()：将 Temporal.ZonedDateTime 转换为 Temporal.Instant。

下面是一个示例代码：

const local = Temporal.ZonedDateTime.from('2022-02-22T22:22:22.222+08:00[Asia/Shanghai]');
const utc = local.toInstant();
console.log(`UTC equivalent to ${local}: ${utc}`);

`Temporal.Duration`

Temporal.Duration 表示一段时间，与 Temporal.Instant 类似，但它是可变的。它可以计算两个时间点之间的时间差，或为给定的周期设置时间段，例如 "P1Y" 表示一年。

下面是 Temporal.Duration 的一些方法：

from()：将任何类型的数据转换为 Temporal.Duration。接受一个对象参数，其中可能包含 years、months、weeks、days、hours、minutes、seconds、milliseconds 和 microseconds。
add()：将当前持续时间增加给定时间后返回新的 Temporal.Duration。
subtract()：将当前持续时间减去给定时间后返回新的 Temporal.Duration。
total()：返回持续时间的总长度。接受一个对象参数，其中可能包含 units、largestUnit 和 smallestUnit。

下面是一个示例代码：

const a = Temporal.Duration.from({ days: 10, hours: 2 });
const b = Temporal.Duration.from({ hours: 15, minutes: 30 });
const sum = a.add(b);
const diff = b.subtract(a);
console.log(`a + b = ${sum.total({ units: ['hours', 'minutes'] })}`);
console.log(`b - a = ${diff.total({ units: ['hours', 'minutes'] })}`);

Temporal API 的指导意义

ECMAScript 2021 引入的 Temporal API 为 JavaScript 中时间和日期的处理提供了完整的解决方案。相比之前使用原始数据类型和不完整的时间和日期函数实现，这个 API 更加直观、安全和可维护。

使用 Temporal API，我们可以做到：

更准确地表示日期、时间和时间段，而不用担心时区或夏令时等问题。
更容易地比较和组合时间和日期，而不用考虑诸如 "30 天是多少小时" 这样的转换，并且避免了由于精度问题而导致的错误。
更好地处理日期和时间的间隔和时差，而不用手动计算。

然而，需要注意的是，Temporal API 并不完全兼容所有浏览器和运行时版本。在使用这个 API 时，我们需要先检查它是否存在，并相应地提供后备代码。

结论

ECMAScript 2021 引入的 Temporal API 是 JavaScript 中一个非常有用的新的时间和日期 API。通过使用这个 API，我们可以更轻松地处理时间和日期，并避免许多相关问题。

在实际应用中，我们需要根据具体需求选择合适的类和方法，并考虑 API 兼容性问题。同时，我们也需要学习和掌握 API 的各种特性和使用技巧，以便更加高效地使用和维护这个新的 API。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/676d102782fcee791c63bc4c