date-fns-tz
date-fns 的时区扩展库,用浏览器 Intl API 处理 IANA 时区,提供按指定时区格式化、UTC 与本地时间互转等函数,给前端和 Node.js 开发者用。
2 次可以打开平均 4.1 秒
本站从国内机房定期实测。竖条由远及近:绿 = 可以打开,橙 = 国内不可直接访问,灰 = 打不开。date-fns-tz 是 date-fns 的配套库,补上后者缺的时区能力。date-fns 返回的始终是普通 JS Date,隐含当前系统时区;要显示「洛杉矶晚上 8 点」这类固定时区的时间,就得自己算偏移。这个库把这类计算包成函数,时区数据交给浏览器的 Intl API,不必往打包产物里塞时区表。
主要功能
核心是 formatInTimeZone:不管系统时区是什么,都按传入的时区格式化日期。fromZonedTime 把某个时区的日期换算成等价的 UTC 时间,toZonedTime 反过来从 UTC 得到某时区的本地时间,getTimezoneOffset 给出该时区与 UTC 的毫秒差。
它还扩展了 date-fns 的 format,支持 z 到 zzzz 的时区标记;toDate 能从任意时区的日期字符串解析出 Date。库同时提供 CommonJS 和原生 ESM 入口,package.json 的 exports 字段按项目类型选入口,两种项目用同一条 import 路径。
适合谁
用 date-fns 做日期处理、又需要显示或换算非本地时区的项目。典型场景是服务端渲染、跨时区的活动时间展示。date-fns 是它的 peer dependency,需要自己装。
限制
依赖 Intl API,老浏览器和部分环境要加 polyfill;不加 polyfill 就只能用「-0200」「+04:00」这类偏移量,不能用 America/New_York 这样的 IANA 时区名。README 另有一节讲 Android 上的用法。项目采用 MIT 许可证,仓库约 1.2k star、112 个 fork,有 68 个未关闭 issue。
