Temporal 是 ES2025 正式标准,提供不可变、时区明确、ISO 8601 兼容的时间处理 API,通过 Instant、PlainDate、ZonedDateTime 等类型分离职责,彻底解决 Date 对象的可变性、隐式本地时区、月份从 0 开始等根本缺陷。
Temporal 是 JavaScript 中一项已进入标准正式阶段(ECMAScript 2025,即 ES15)的提案,它提供了一套全新、不可变、基于国际标准(ISO 8601 和 IANA 时区数据库)设计的时间处理 API,旨在彻底替代长期饱受诟病的 Date 对象。
JavaScript 的 Date 对象自诞生以来就存在多个根本性缺陷:
setFullYear()、setHours())都直接修改原对象,容易引发意外副作用和竞态问题;toString() 等方法默认使用宿主环境本地时区,但解析字符串时又依赖实现,行为不一致;new Date(2025, 0, 1) 表示 1 月 1 日,而 date.getMonth() 返回 0,违反直觉且易出错;new Date("2/3/45") 解析结果因引擎而异,且 getYear()(已废弃)返回两位年份;Temporal 引入多个专用、不可变类,各司其职,消除歧义:
Temporal.Now.instant() 或 Temporal.Instant.fromEpochMilliseconds() → 表示**绝对时间点**(UTC 纳秒级精度),不依赖时区;Temporal.PlainDate.from("2025-05-20") → 纯日期(年-月-日),无时间、无时区;Temporal.PlainTime.from("14:30:00") → 纯时间(时:分:秒.毫秒),无日期、无时区;Temporal.PlainDateTime.from("2025-05-20T14:30") → 本地日期+时间,仍无时区;Temporal.ZonedDateTime.from("2025-05-20T14:30-07:00[America/Los_Angeles]") → 明确绑定时区的完整时间,支持夏令时和历史时区规则;Temporal.Duration → 专门表示时间间隔(如 { hours: 2, minutes: 30 }),可安全加减,不混淆于时间点。Temporal 通过设计约束根除传统陷阱:
.with({ hour: 15 }) 或 .plus({ days: 1 }))都返回新实例,杜绝副作用;"UTC" 或 "Asia/Shanghai")才能生成 ZonedDateTime;from() 和 toString() 方法严格遵循 ISO 格式,无歧义;Temporal 并未移除 Date,而是提供现代替代方案。你可以:
Temporal.Instant.from(date) 将旧 Date 转为精确时间点;date.toTemporalInstant()(若环境支持)做同样转换;Temporal 类型,避免再踩坑;Temporal.PlainDateTime.toLocaleString() 或 ZonedDateTime.toLocaleString() 安全格式化输出,无需依赖 Date.prototype.toLocaleString
() 的不可靠行为。不复杂但容易忽略:它的价值不在功能堆砌,而在让时间计算变得可推理、可测试、跨环境一致——这是过去二十年 JavaScript 时间处理一直缺失的确定性。