Temporal：JavaScript中的全新日期API - DanneManne

Temporal API 是 JavaScript 中一项全新的日期处理提案，旨在解决现有 Date 对象的诸多局限性。虽然目前该提案仍处于第 3 阶段，但它带来了许多令人兴奋的功能，未来有望成为开发者处理日期和时间的首选工具。本文将深入探讨 Temporal API 的工作原理、核心数据类型以及其提供的强大功能。

Temporal API 是如何工作的？

Temporal API 是通过一个名为 Temporal 的全局对象实现的，它包含了一系列新的类和函数。一个显著的特点是支持处理没有时间的日期，这在 JavaScript 中一直是一个难点。通过 Temporal，开发者可以更轻松地管理日期和时间相关的操作。

Temporal 中的 API 类型

Temporal 提供了多种数据类型，开发者可以根据具体需求选择合适的类型，而无需处理与用例无关的日期部分。例如：

不需要时区的应用场景：使用 Plain 类型。
时间无关紧要的场景：Temporal 提供了相应的类型。

以下是一些常用的类型及其特点：

PlainDateTime

PlainDateTime 是最常用的类型之一，它只处理日期和时间，而不涉及时区的复杂性。可以通过 plainDateTimeISO 函数创建一个实例：

const dateTime = Temporal.PlainDateTime.from('2023-10-25T10:00:00');

该对象仅解析时间，不存储时区信息。此外，还可以使用 from 方法通过字符串或对象创建实例。

PlainDate

PlainDate 表示没有时间或时区的日期。这种类型非常适合用于只需要日期的场景，例如记录生日或节假日。

PlainTime

PlainTime 与 PlainDate 相反，它仅表示时间而不包含日期。由于时间与日历无关，因此没有类似 Now.plainTime 的函数。

ZonedDateTime

ZonedDateTime 是最接近传统日期对象的类型，它包含日期、时间和时区信息，并能够处理夏令时等复杂计算。

Instant

Instant 表示一个特定的时间点，始终以 UTC 时间为基础。与 ZonedDateTime 不同，Instant 不考虑日历信息。

PlainMonthDay 和 PlainYearMonth

PlainMonthDay：表示没有年份的日期，例如节假日或生日。
PlainYearMonth：表示某年的某个月，适合用于表示月度数据或文档。

时区和持续时间

时区：用于表示特定的时区。
持续时间：表示两个时间点之间的时间差，支持加减、舍入等操作。

辅助方法

Temporal 提供了丰富的辅助方法，用于操作和比较日期对象。值得注意的是，所有 Temporal 对象都是不可变的，任何操作都会返回一个新的实例。

添加和减去时间

可以通过传递一个对象来增减时间：

const newDate = dateTime.add({ days: 1 });

比较时间

Temporal 提供了便捷的比较方法，例如比较两个时间对象是否相等或计算它们之间的差异：

const duration = Temporal.PlainDate.compare(date1, date2);

替换部分时间

可以基于现有对象替换其中的某些部分：

const updatedDate = dateTime.with({ hour: 15 });

舍入时间

通过传递参数配置舍入规则，例如最小单位或舍入模式：

const roundedDate = dateTime.round({ smallestUnit: 'minute' });

浏览器支持

目前，Temporal API 仍处于第 3 阶段，尚未被主流浏览器支持。如果想要尝试，可以通过添加 polyfill 来实现。

总结

Temporal API 为 JavaScript 的日期和时间处理带来了革命性的改进，其丰富的数据类型和强大的功能使开发者能够更高效地处理复杂的时间逻辑。尽管目前浏览器支持尚未完善，但它的前景令人期待。希望本文能为您带来启发，助您在未来的项目中更好地利用 Temporal API。

感谢阅读，祝您编码愉快！

原文链接: https://dannemanne.com/posts/temporal_the_new_date_api_in_javascript