旧浏览器也能用上 Temporaltemporal-polyfill 兼容性与支持矩阵完整解读【免费下载链接】temporal-polyfillA lightweight polyfill for Temporal, successor to the JavaScript Date object项目地址: https://gitcode.com/gh_mirrors/tempo/temporaltemporal-polyfill是一个专为 JavaScript 打造的轻量级 Temporal polyfill用于在旧浏览器中提前体验 Temporal——这个被官方视为 Date 对象继任者的新一代日期时间 API。本文为你完整解读 temporal-polyfill 的浏览器兼容性、支持矩阵与多种引入方式帮你快速判断老项目能不能安全用上 Temporal最低要什么版本怎么接入最省心一句话总结temporal-polyfill 压缩后仅19.5 kB规范符合度近乎完美可让 Chrome 67、Firefox 68、Safari 14 等「上了年纪」的浏览器也能流畅运行完整的 Temporal API。为什么旧浏览器用不上原生 TemporalJavaScript 开发者苦Date对象久矣时区混乱、加减日期繁琐、日历系统缺失……这正是 TC39 推出Temporal的初衷。Temporal 提供PlainDate、PlainTime、ZonedDateTime、Duration、Instant等类型把日期时间的运算、比较、格式化做得清晰而严谨。但现实问题是Temporal 仍处于提案阶段主流浏览器尚未全面落地原生支持覆盖面远未普及。也就是说如果你的项目要兼容大量旧版本浏览器直接写Temporal.*代码很可能「跑不起来」。Temporal polyfill正是解决这一痛点的关键它用纯 JavaScript 实现了完整的 Temporal 规范让旧浏览器也能获得一致的行为。temporal-polyfill 是什么为什么值得选它temporal-polyfill 由 FullCalendar 团队维护是目前体积最小、规范符合度最高的 Temporal 兼容方案之一。它的核心优势可以概括为四点极致轻量基础版 mingzip 仅 19.5 kB全日历版 23.4 kB✅高度合规与最新 Temporal 规范近乎完美对齐仅有 2 处有意偏离自动降级支持原生优先策略——环境自带原生 Temporal 时直接复用可摇树优化额外提供函数式 API按需打包进一步压缩体积项目的完整使用说明与入口清单可参考官方文档 polyfill/README.md兼容性细节与体积对比数据则记录在 polyfill/scripts/size-comparison/RESULTS.md 中。temporal-polyfill 浏览器支持矩阵最低版本要求一览这是本文的重头戏。temporal-polyfill 从v1.0.1起要求运行环境支持 BigInt因此浏览器最低版本以 BigInt 的普及程度为基准。官方支持矩阵如下浏览器最低版本发布时间使用 chinese / dangi / islamic-umalqura 日历Chrome672018年5月802020年2月Firefox682019年7月762020年5月Safari142020年9月14.12021年4月Safari iOS142020年9月14.52021年4月Edge792020年1月802020年2月解读这张 Temporal polyfill 兼容性表格普通项目只要浏览器不低于上述「最低版本」列即可正常使用 Temporal 的全部核心功能ISO 日历场景特殊日历项目若涉及中国农历chinese、藏历dangi或伊斯兰历islamic-umalqura等复杂历法则需要更高的浏览器版本因为这类日历依赖宿主环境的Intl数据。Node.js 支持情况服务端同样友好Node.js 最低支持162021年4月发布且项目的 CI 会对 Node 16、18、20、22、24、26 六个版本运行完整测试套件确保各 LTS 版本的兼容性有保障。BigInt 是硬门槛兼容性下限的真正来源为什么 temporal-polyfill 无法支持更老的浏览器关键在于BigInt。从 v1.0.1 起项目明确要求运行环境必须支持 BigInt因为内部的时间精度计算纳秒级依赖它。v1.0.0 时代曾支持无 BigInt 的环境但为了换取更小的体积与更高的计算性能新版选择了「向前看」。所以如果你的用户群体还停留在 IE 或 2018 年之前的浏览器请务必先评估 BigInt 支持情况——这也是整个 Temporal polyfill 兼容性决策中最重要的一条前提。日历系统支持基础版与 full 版怎么选temporal-polyfill 把日历支持拆成了两个层级按需引入基础版默认入口仅支持iso8601与gregory两种日历覆盖绝大多数业务场景full 版/full/入口额外支持 14 种日历——buddhist、chinese、coptic、dangi、ethiopic、ethioaa、hebrew、indian、islamic-civil、islamic-tbla、islamic-umalqura、japanese、persian、roc。如果项目涉及佛历、农历、希伯来历等非 ISO 日历记得改用temporal-polyfill/full/global这类入口否则会报错或行为异常。这一拆分也是 v1.0.1 的 breaking change升级时尤其要注意详见 polyfill/CHANGELOG.md。五种引入方式从全局 polyfill 到 CDN 一行接入temporal-polyfill 的接入方式非常灵活总有一种适合你的项目全局 polyfill最常用——import temporal-polyfill/global自动优先使用原生 TemporalPonyfill 本地导入——import { Temporal } from temporal-polyfill无副作用、不污染全局强制非原生——import { Temporal } from temporal-polyfill/implementation适合测试或调试按需安装——通过temporal-polyfill/shim的install()方法在自定义条件下才注入全局CDN 一行引入——适合纯 HTML 页面直接用 script 标签引入 jsdelivr 上的temporal-polyfill1.0.2/global.min.js即可在全局使用Temporal。一个最典型的全局引入示例import temporal-polyfill/global Temporal.Now.zonedDateTimeISO().toString() // 例如2026-08-20T07:49:1208:00[Asia/Shanghai]对于追求极致包体积的组件库作者项目还提供了函数式的tree-shakeable API入口位于temporal-polyfill/fns/*按需打包单个函数详细文档见 docs/fns/index.md。体积对比19.5 kB 完胜同类方案「轻量」不是口号而是有实测数据的。项目官方对比了同领域最知名的方案js-temporal/polyfill包基础日历mingzip全日历mingziptemporal-polyfill19.5 kB23.4 kBjs-temporal/polyfill52.1 kB167%52.1 kB123%差距悬殊的根本原因temporal-polyfill 只在关键处使用原生bigint而同类方案内部依赖额外的 JSBI 大数库此外 temporal-polyfill 还支持通过 ESM 与 CDN 安装全局 polyfill这也是同类方案目前做不到的。数据来源polyfill/scripts/size-comparison/RESULTS.md。规范符合度几乎满分的 test262 通过率兼容性不止看浏览器版本更要看行为是否规范。temporal-polyfill 使用 TC39 官方 test262 测试套件持续校验与最新 Temporal 规范仅存在2 处有意偏离浮点除法精度规范要求更高精度的大数除法项目为控制体积与性能采用原生 JS 除法极端场景下结果可能存在细微尾数差异ChainDateTimeFormat 未实现这是 ES5 时代遗留的兼容路径与 Temporal 本身无关属于规范的「可选实现」。完整的偏离清单与原因说明见 polyfill/scripts/test262-expected-failures/shim.txt。对绝大多数业务而言这两处差异完全可以忽略。升级与兼容性注意事项如果你的项目正从旧版本升级或计划把现有代码迁移到 Temporal请留意 v1.0.1 起的三个关键变化⚠️BigInt 成为硬性要求最低浏览器版本相应提高⚠️非 ISO 日历需切换到/full/入口基础入口不再支持⚠️放弃 CJS仅保留 ESM 与全局 IIFENode 最低要求提升到 16。另外官方还提供了配套的 codemod 工具codemod/README.md可把函数式 API 自动改写回标准Temporal.*写法让「先 polyfill、后原生」的迁移路径变得平滑无痛。总结旧浏览器接入 Temporal 的最佳姿势一句话结论temporal-polyfill 是旧浏览器使用 Temporal 的最优解。它用 19.5 kB 的体积换来近乎 100% 的规范符合度支持 Chrome 67、Firefox 68、Safari 14、Node 16 的广泛兼容范围并提供全局 polyfill、ponyfill、shim、CDN、函数式 API 五种接入姿势。如果你的项目需要兼容 2018 年以来的主流浏览器又渴望提前用上规范、好用的现代日期时间 API那么 temporal-polyfill 值得立刻加入依赖清单 【免费下载链接】temporal-polyfillA lightweight polyfill for Temporal, successor to the JavaScript Date object项目地址: https://gitcode.com/gh_mirrors/tempo/temporal创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考