如何利用 ES12 中新增的 Temporal API 管理日期时间

ES12 中新增的 Temporal API，为 JavaScript 中日期时间的管理提供了全新的方式。它提供了一种比原生 Date 对象更为强大和灵活的 API，支持更多的操作并且在类型安全和时区处理上更为出色。在这篇文章中，我们将会深入介绍 ES12 Temporal API 的理念，如何在项目中使用 Temporal 并学会它的常见用法和示例代码。

Temporal API 的理念

由于 JavaScript 中的原生 Date 对象有限，为了提高开发效率，ES12 引入了 Temporal API。Temporal API 理解为 "时间的API"，主要的特点是：

1. 支持对日期时间进行计算
2. 支持比较和格式化
3. 支持对时区和跨时区的计算和处理
4. 具有类型安全等特性。

以这些特性作为基础，我们可以更加精细和方便的使用 JavaScript 中的日期时间。

如何在项目中使用 Temporal

使用 Temporal API 需要在项目中引入 Temporal 模块。在我们的项目中，我们可以使用以下方式引入 Temporal 模块：

import { Temporal } from '@js-temporal/polyfill';

这里的 @js-temporal/polyfill 是 Temporal API 的一个 polyfill。在项目中使用完毕，我们需要将代码中的 import 替换成在 polyfill 手动引入的方式即可。

Temporal API 的常见用法

下面我们将简单介绍 Temporal API 的常见用法：

创建 Temporal 实例

我们可以创建一个 Temporal 实例来对日期进行操作：

const date = Temporal.now.date();
console.log(date.toString()); // "2022-07-14"

操作 Temporal 实例

使用实例的 add()、subtract()、until()、since() 方法对日期进行加、减或比较：

const date = Temporal.now.date();
const plus1MonthDate = date.add({months: 1});
console.log(plus1MonthDate.toString()); // "2022-08-14"

const now = Temporal.now.instant();
const anotherDate = Temporal.PlainDate.from("2022-07-10");
const duration = now.until(anotherDate);
console.log(duration.total({unit: "days"})); // -4

Temporal 类型转换

可以使用 from() 和 to() 方法进行字符串和 Temporal 类型之间的转换：

const str = "2022-07-14";
const instant = Temporal.Instant.from(str + 'T00:59:59.999999999Z');
const formattedStr = instant.to(Temporal.PlainDateTime).toString();
console.log(formattedStr); // "2022-07-14T00:59:59.999999999"

格式化日期

使用 Temporal API 手动格式化日期：

-- -------------------- ---- -------
----- ------------- - -------------------------------------------------------------
------------
  -------------------------------- -
    ---------- ------
    ------ ----------
    ---- ----------
    ----- ----------
    ----- ----------
    ------- ----------
    ------- ----------
    ----------------------- --
    -------------------------- ---
  --
-- ------------- ------------

结论

ES12 Temporal API 提供了一组比原生 Date 对象更加全面和强大的时间操作 API，支持更多的日期操作和管理方式，以及更好的时区和类型安全处理，它可以在 JavaScript 中更好的管理日期时间。无论是在前端应用还是后端应用程序、框架或库中，这是一种强大的工具，值得开发人员掌握，应该在项目中广泛使用。

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