js-joda

JavaScript 的不可变日期时间库,按 ISO 日历把日期、时间、时区拆成 LocalDate、ZonedDateTime 等类型,自带 ISO 8601 解析与格式化,适合在 React 里处理生日、节假日这类无时间的日期。

打开官网替代品 6 个 本站 11 月 22 日 实测可以打开
最近 4 次实测

4 次可以打开平均 1.9 秒

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

js-joda.github.io 首页 · 本站实拍 · 点开看大图

js-joda 是一个 JavaScript 的日期时间库,用不可变对象表示日期、时间、时区和时间段。它不包装原生的 Date,而是自己实现了一套按 ISO 日历(前推格里高利历)计算的类型,API 参照 Java 8 的 java.time,从 threetenbp 移植而来。原生 Date 总是把日期、时间和时区绑在一起,js-joda 则按用途拆成不同类,比如只表示生日、节假日这类没有时间的日期,就用 LocalDate。

主要类型

核心包提供 LocalDate、LocalTime、LocalDateTime、ZonedDateTime、Instant,以及 Duration(如 34.5 秒)和 Period(如 2 年 3 个月 4 天)。另有 Year、YearMonth、Month、MonthDay、DayOfWeek 等值类型。所有对象不可变,加减和修改字段都返回新实例,适合配合 React 这类强调纯函数的框架。

格式化与解析内置对 ISO 8601(RFC 3339)的支持,可以自定义格式模式,也能按 locale 输出。时区数据单独放在 @js-joda/timezone 包里,locale 支持另有独立包,可按需引入以控制体积。

安装与使用

Node 环境用 npm 安装 @js-joda/core,然后 require 出需要的类;浏览器可以直接从 CDN 取 dist/js-joda.min.js,用 script 标签引入后通过全局 JSJoda 访问。压缩后约 43 kB,没有第三方依赖。文档里给了从原生 Date 与 js-joda 对象互相转换的写法,也说明了如何自定义 adjuster、字段、单位和格式化器。

适合谁

需要在浏览器或 Node 里做严谨日期运算的开发者,尤其是要处理时区切换、夏令时跨越、日期持久化到服务端等场景的人。项目移植了 threetenbp 的 1700 多个测试用例,测试跑在 Firefox、Chrome、Node 和 phantomjs 上。

常见问题

用 js-joda 要登录吗?
不用登录就能用。
js-joda 有哪些平台 / App?
支持 网页。

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

替代品 6打开官网