简介
Temporal API 是在 ECMAScript 中引入的一个新的公共 API，它旨在提供一种更加简单、正确和安全的方法来处理日期和时间。它提供了一个更加严格的日期和时间模型，同时也解决了一些常见的问题，例如时区和日历。
Temporal API 在 ECMAScript 2021 (ES12) 中正式成为了标准。在本文中，我们将会介绍一些基本概念和 API，同时也会提供一些示例代码来帮助你更好地理解和使用这些功能。
基本概念
Temporal API 引入了两个核心概念：Temporal.Instant 和 Temporal.ZonedDateTime。
Temporal.Instant 表示一个精确的日期和时间，可以精确到纳秒级别。它不受时区影响，并且可以表示的时间范围非常广泛，从大约 100 亿年前到 100 亿年后。
Temporal.ZonedDateTime 是基于时区的日期和时间，它包括一个 Instant 对象以及一个时区信息。因此，它不仅可以精确到纳秒级别，还能够正确地表示时区。它还包括其他信息，例如地理位置等。
使用 Temporal API 处理日期和时间
创建一个 Instant 对象
要创建一个 Instant 对象，我们可以使用 Temporal.Instant 的构造函数。例如，下面的代码将会创建一个代表当前时间的 Instant 对象：
const now = Temporal.Instant.now();
console.log(now); // 输出：Temporal.Instant {epochNanoseconds: xxxxxxxxx}创建一个 ZonedDateTime 对象
要创建一个 ZonedDateTime 对象，我们需要同时指定一个 Instant 和一个时区。例如，下面的代码将会创建一个表示当前时间在太平洋时区的 ZonedDateTime 对象：
const pacificZone = Temporal.TimeZone.from('America/Los_Angeles');
const now = Temporal.Instant.now();
const zonedDateTime = new Temporal.ZonedDateTime(now, pacificZone);
console.log(zonedDateTime); // 输出：Temporal.ZonedDateTime {year: xxxx, month: x, day: x, hour: x, minute: x, second: x, millisecond: x, microsecond: x, nanosecond: x, timeZone: xxxxxxx}使用操作符
Temporal API 提供了一些操作符，可以用于在 Instant 和 ZonedDateTime 上进行数学和比较操作。例如，我们可以使用 Temporal.Instant 的 add() 方法来在 Instant 上增加一定数量的时间：
const now = Temporal.Instant.now();
const future = now.add({ days: 1, hours: 2, minutes: 30 });
console.log(future); // 输出：Temporal.Instant {epochNanoseconds: xxxxxxxxx}我们也可以使用 Temporal.ZonedDateTime 的 until() 方法来计算两个 ZonedDateTime 之间的时间差：
const pacificZone = Temporal.TimeZone.from('America/Los_Angeles');
const now = Temporal.ZonedDateTime.now(pacificZone);
const tomorrow = now.add({ days: 1 });
const duration = now.until(tomorrow);
console.log(duration); // 输出：Temporal.Duration {seconds: 86400}格式化日期和时间
Temporal API 还提供了一种简单的方法来格式化日期和时间。我们可以使用 Temporal 的 Intl.DateTimeFormat() 方法来创建一个日期和时间格式化器，并使用它来将日期和时间格式化为字符串。
例如，下面的代码将会创建一个在东京时区的 ZonedDateTime 对象，并将其格式化为一个本地化的日期格式：
-- -------------------- ---- ------- ----- --------- - ------------------------------------- ----- --- - -------------------------------------- ----- --------- - --- ---------------------------- - ----- ---------- ------ ------- ---- ---------- -------- ------- ----- ---------- ------- ---------- ------------- ------- --- ----------------------------------- -- ---------------- ----- ---
总结
Temporal API 提供了一种更加简单、正确和安全的方法来处理日期和时间。它引入了 Instant 和 ZonedDateTime 两个核心概念，并提供了一些操作符和方法，方便我们对其进行数学和比较操作。同时，它还提供了一种简单的方法来格式化日期和时间，并且支持多种语言和时区。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64cda6671519ea946c1744f4