js-joda
JavaScript 的不可变日期时间库,按 ISO 日历把日期、时间、时区拆成 LocalDate、ZonedDateTime 等类型,自带 ISO 8601 解析与格式化,适合在 React 里处理生日、节假日这类无时间的日期。
4 次可以打开平均 1.9 秒
本站从国内机房定期实测。竖条由远及近:绿 = 可以打开,橙 = 国内不可直接访问,灰 = 打不开。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 上。
