UD5工具箱
Temporal API 是什么？与 Date 有什么不同？
Temporal 是 ECMAScript 的 Stage 3 提案，旨在取代有缺陷的 Date 对象。核心优势包括：不可变性——所有操作返回新对象，无副作用；类型明确——PlainDate（纯日期）、PlainTime（纯时间）、ZonedDateTime（带时区）等类型各司其职；时区安全——原生支持 IANA 时区数据库，自动处理夏令时；纳秒精度——远超 Date 的毫秒精度；直观 API——.add()、.subtract()、.since() 等语义化方法。本演练场内置了 Temporal polyfill，让你可以直接在当前浏览器中体验这些特性。
Temporal 目前可以在生产环境使用吗？
截至 2025 年，Temporal 仍处于 Stage 3，尚未被所有浏览器原生支持。但你可以通过 @js-temporal/polyfill 在生产环境中使用。该 polyfill 体积约 50KB（gzip），API 与规范保持一致，当浏览器原生支持时会自动使用原生实现。本演练场已自动加载该 polyfill，你可以在工具中直接运行 Temporal 代码，体验完整的 API 功能。
如何从 Date 迁移到 Temporal？
主要的迁移映射：new Date() 改为 Temporal.Now.plainDateTimeISO()；Date.now() 改为 Temporal.Now.instant().epochMilliseconds；date.getFullYear() 改为 plainDate.year；date.setDate(date.getDate()+7) 改为 plainDate.add({days:7})；date1 - date2 改为 date1.since(date2).days。迁移核心是拥抱不可变模式和明确的类型系统。建议先在项目中引入 polyfill，逐步替换 Date 代码，而不是一次性大规模迁移。
PlainDate 和 ZonedDateTime 有什么区别？
PlainDate 仅包含日期（年、月、日），不包含时间和时区信息，适合生日、节假日等场景。ZonedDateTime 包含日期、时间和时区的完整表示，能正确处理夏令时转换，适合会议安排、航班时间等场景。选择原则：如果事件的具体时刻在全球范围内有意义（如视频会议、航班起飞），使用 ZonedDateTime；如果只关心日历日期（如生日、纪念日），使用 PlainDate。在本工具的「日期基础」和「时区处理」实验中分别展示了两种类型的用法。
Duration 的 total() 方法有什么用？
duration.total({unit:'hours'}) 将时间段转换为指定单位的浮点数总和。例如 {days:1, hours:6} 使用 .total({unit:'hours'}) 返回 30。这在需要计算总时长、做数值比较或生成图表数据时非常有用。注意需要提供参考日期来处理可变长度单位（如月份，因为不同月份的天数不同）。在本工具的「时间段计算」实验中可以体验 total() 的实际效果。
Temporal 如何处理夏令时？
ZonedDateTime 使用 IANA 时区数据库，自动处理夏令时。例如在 America/New_York 时区添加 1 天会正确处理 DST 转换日（3 月第二个周日和 11 月第一个周日）。PlainDateTime 则不处理 DST，适合不需要时区语义的场景。这是 Temporal 相比 Date 的重大改进之一——Date 对象完全没有时区概念，所有操作都基于 UTC 偏移。在本工具的「时区处理」实验中可以对比不同时间区的行为差异。
Temporal 的精度能达到什么级别？
Temporal 支持从纳秒到年的完整范围。Instant 类型可以表示约 27 万年的时间范围，精度为纳秒。这在科学计算、金融交易、分布式系统等需要高精度时间的场景中非常关键。对比 Date 仅支持毫秒精度且范围有限。不过在实际 Web 开发中，毫秒精度通常已经足够，纳秒精度更多用于后端和系统级应用。
可以在 Node.js 中使用 Temporal 吗？
可以！安装 npm install @js-temporal/polyfill，然后在代码中 import { Temporal } from '@js-temporal/polyfill' 即可使用。Node.js 18+ 已内置部分实验性支持（需 --experimental-temporal 标志），但推荐使用 polyfill 以获得完整稳定的 API。未来 Node.js 将原生支持 Temporal。在 Node.js 中使用 Temporal 的方式与浏览器中完全一致，polyfill 会自动适配运行环境。