ES12 的 Temporal API 是一个全新的日期和时间操作 API，它可以让开发人员更方便地操作和计算日期和时间。相较于 JavaScript 的传统日期操作，Temporal API 更为严格和准确，同时也更简单易懂。本文将深入解析 Temporal API 的新特性，包括日期与时间操作的实现方法和示例代码。
Temporal 对象的基本操作
以 Temporal 的 Date 对象为例，我们可以使用以下方法来创建和操作日期：
const date = Temporal.Date.from("2022-01-01");
const tomorrow = date.add({ days: 1 });
const lastMonth = date.add({ months: -1 });
const year = date.getISOFields().isoYear;以上代码依次实现了以下操作：
- 通过
Temporal.Date.from()方法创建了一个指定日期的 Date 对象。 - 使用
add()方法对日期进行加减操作。 - 使用
getISOFields()方法获取日期的年份。
需要注意的是，在 Temporal API 中，日期和时间的计算操作都是基于时间点（Instant）的，即加减操作的结果是一个新的时间点对象，并不是像 JavaScript 传统日期操作那样修改原有日期对象。
Temporal 的全局特性与 i18n
Temporal API 支持全局特性，可以根据不同的场景来设置全局默认的时区、系统日历、日期首日等配置。同时它也支持国际化（i18n），可以根据用户的地理位置和语言环境来做出不同的日期和时间显示。下面来看一下示例代码：
-- -------------------- ---- ------- --------------------------------------------- --------------------------------------- ----------------------------------- ----- ----- - --------------------------------- ----- ----- - ------------------------------------ - ----- ---------- --------------------------------- - -- - - ---------------- ------ ------- ---- --------- --- ----- ----- - ------------------------------- - ---------- ------ --- ------------------------------ ------------------- -------------------
以上代码依次实现了以下操作：
- 使用
setDefaultTimeZone()、setDefaultCalendar()和setDefaultFirstWeekday()方法来设置全局的时区、日历和日期首日。 - 创建了一个 Temporal.Date 对象。
- 使用
DisplayNames.of()方法来获取 Temporal API 内置的一个日历名称，以及toString()方法把日期对象格式化成字符串。 - 使用
toLocaleString()方法根据当前地区和语言环境来格式化日期和时间。
Temporal 新特性
Temporal API 中还有一些新特性，包括以下几个方面：
1. 时区和时间戳
Temporal.API 支持对时间点进行时区转换，并能够保存原始的时间戳。下面来看一下示例代码：
-- -------------------- ---- ------- ----- ------- - ---------------------------------------------- --------------------------------------- -------------------------------------------- -------------------------------------------- ----- -------- - ---------------------------------------- ----- ------------- - ---------------------------------- -------------------------------------- ---------------------------------------------
以上代码依次实现了以下操作：
- 创建了一个标准时区的时间点。
- 使用
getEpochSeconds()、getEpochMilliseconds()和getEpochMicroseconds()方法分别获取时间点的秒数、毫秒数和微秒数。 - 创建了一个时区对象，并使用
toZonedDateTime()方法把时间点转换为指定时区的时间点。 - 使用
toString()方法将时间点格式化为字符串，然后使用getEpochSeconds()方法获取时间点的秒数。
2. 日期范围
Temporal.API 中新增了一个 DateRange 对象，可以用来表示时间上的区间。下面来看一下示例代码：
const start = Temporal.Date.from("2022-01-01");
const end = Temporal.Date.from("2022-02-01");
const range = new Temporal.DateRange(start, end);
console.log(range.contains(start.add({ days: 1 })));
console.log(range.contains(end.add({ days: -1 })));
console.log(range.overlaps(range));以上代码依次实现了以下操作：
- 创建了一个 DateRange 对象，表示 2022 年 1 月至 2 月的一个时间段。
- 使用
contains()方法判断此时间段是否包含某个日期。 - 使用
overlaps()方法来判断时间范围是否重叠。
3. 时间间隔
Temporal.API 中同样新增了一个 Duration 对象，可以用来表示时间上的差距。下面来看一下示例代码：
const start = Temporal.Instant.from("2022-01-01T00:00:00Z");
const end = Temporal.Instant.from("2022-01-02T00:00:00Z");
const duration = end.since(start);
console.log(duration.total({ days: "days", hours: "hours", minutes: "minutes", seconds: "seconds" }));
console.log(duration.toString());以上代码依次实现了以下操作：
- 创建了一个时间点对象。
- 通过
since()方法计算了两个时间点之间的时间差，获得了一个 Duration 对象。 - 使用
total()方法来返回 Duration 对象的总时间，以及toString()方法将 Duration 对象格式化为字符串。
总结
Temporal API 是一个全新的日期和时间操作 API，它更为严格和准确，同时也更简单易懂，可以让开发人员更方便地操作和计算日期和时间。本文深入解析了 Temporal API 的新特性，包括日期与时间操作的实现方法和示例代码，希望能够对开发人员有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64acb19a48841e989489ef14