date-fns-tz

github.com又名 date-fns timezone

date-fns 的时区扩展库,用浏览器 Intl API 处理 IANA 时区,提供按指定时区格式化、UTC 与本地时间互转等函数,给前端和 Node.js 开发者用。

打开官网替代品 3 个 本站 11 月 20 日 实测:国内不可直接访问
最近 3 次实测

2 次可以打开平均 4.1 秒

本站从国内机房定期实测。竖条由远及近:绿 = 可以打开,橙 = 国内不可直接访问,灰 = 打不开。
github.comdate-fns-tz 首页截图

github.com 首页 · 本站实拍 · 点开看大图

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。

常见问题

date-fns-tz 收费吗?
date-fns-tz 免费使用。
用 date-fns-tz 要登录吗?
不用登录就能用。
date-fns-tz 有哪些平台 / App?
支持 网页。

替代品全部 3 个,带对比表 →

替代品 3打开官网