拆解 JS 的新一代日期时间 API

老 Date 把「时刻、墙上时间、日历日期、一段时长」全揉进一个可变对象里，还会隐式地替你换算时区。Temporal 把它们拆成一组各司其职、不可变的类型：要精确时刻用 Instant，要某地的墙上时间用 ZonedDateTime，要纯日期 / 纯时间用 Plain*，要一段时长用 Duration。每个 demo 都能改输入、看真实运行结果（底层跑 temporal-polyfill）。全文四步：ISO 8601、类型全景、Temporal.Now、Duration。

1 · ISO 8601:Temporal 的「母语」

每个 Temporal 类型都用 ISO 8601 字符串来 toString() 序列化、也用它来 from() 解析。先把一条「信息最全」的字符串逐段拆开，认全每一块的含义。

1.1 · 拆解一条完整字符串

下面是一个 ZonedDateTime 的 ISO 形式。点下面的图例，高亮对应段并看解释：

1.2 · 反过来：同一段文字，解析成不同类型

把一段 ISO 文本喂给不同的 Temporal.X.from(...)，每个类型只「认领」它关心的部分。改下面的输入或切换类型，看真实解析结果（from 后再 toString() 转回来）：

1.3 · 时长(Duration)：另一套 ISO 写法 $P\dots T\dots$

时长不写成「日期」，而是 P（Period，期）起头的串：P 后面是日期部分（年 Y / 月 M / 周 W / 日 D），再用一个 T 分隔出时间部分（时 H / 分 M / 秒 S）。所以 P30D = 30 天、PT1H = 1 小时、P1Y2M10DT2H30M = 1 年 2 月 10 天 2 时 30 分。

2 · 类型全景：谁带哪些信息

Temporal 不是单个通用类，而是一组各装不同信息的不可变类型。点下面任意一张卡，查看它带有哪几个字段、并配一个真实场景运行一遍。关键直觉：从「纯时刻」到「带时区+历法」信息逐级变多，按需取用。

3 · Temporal.Now：读「现在」的工具集

Temporal 的类型本身不可变、也不知道「现在」是几点——这是故意的（纯值，可测试、可缓存）。要拿「此刻」，得显式问 Temporal.Now 这组函数。它返回的也都是普通 Temporal 值，拿到后该是哪种类型就当哪种类型用。下面是一个实时刷新的时钟。

3.1 · Temporal.Now.* 工具箱（实时）

同一刻，问不同的 Now 方法，拿到不同类型的值：

3.2 · 同一刻，不同时区的「墙上时间」

下面几行是同一个 Instant（此刻），用 zonedDateTimeISO(zone) 投影到不同时区。时刻相同，钟面不同——这正是 Instant 与 ZonedDateTime 的分工（见「类型全景」那节）。

4 · Duration:「一个月」不是固定天数

最反直觉的一点：Duration 描述的是日历意义上的「多久」，不是一个毫秒数。P1M（1 个月）到底多少天？不知道——要看你从哪一天起算：可能 28、29、30 或 31 天。所以日历单位的时长，必须配一个起点才能落地。

4.1 · 合同结束日 = 合同开始日 + 合同期限

这是 Duration 最自然的用法：一个日期 .add() 一段时长，得到新日期。改改看：

4.2 · 同样是 P1M，落在不同起点 = 不同天数

下面每一行都是「起点 + 同一个时长」，但实际跨过的天数各不相同。注意 1 月 31 日 + P1M 会被钳到 2 月底（没有 2 月 31 日）。改时长试试：

4.3 · 验证：脱离起点，Duration 答不出「多少天」