返回资讯中心
外部精选
软件工程
#开发者实时流

开发者用 WebAssembly 将 Rust 的 Jiff 日期库引入 JavaScript

来源标题:Show HN: I built a JavaScript library on Rust's amazing Jiff via WebAssembly

开发者将 Rust 的 Jiff 1.0.0 日期时间库编译为 WebAssembly,供 JavaScript 直接使用,无需 Rust 环境。该包名为 jiff-js,内置 IANA 时区数据库,不依赖 Temporal 或 polyfill,也不修改全局对象,要求 Node.js 20 或以上版本。

Hacker News 最新modinfo2026/11/17 · 今天21 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

用 JavaScript 调用 Rust 原版 Jiff 日期时间库。Jiff 1.0.0 以预编译 WebAssembly 形式运行,并内置了 IANA 时区数据库。使用者无需安装 Rust。Jiff 是唯一的日期时间引擎,不依赖 Temporal 或 polyfill,包也不会修改全局对象。这个独立包暴露了 Jiff 中一个有文档记录的子集。需要 Node.js 20 或更高版本。发布后,用 npm install jiff-js 安装。对于当前这份代码检出,请按下面说明构建并安装 tarball。

import { Timestamp, Span } from 'jiff-js'; const start = Timestamp.from('2024-07-11T01:14:00Z'); const end = start.inTz('America/New_York') .add(Span.new().months(1).hours(2)); console.log(end.toString()); // 2024-08-10T23:14:00-04:00[America/New_York] console.log(end.timestamp().toString()); // 2024-08-11T03:14:00Z

CommonJS 使用相同的 API,并自动加载 WASM:

const { Timestamp } = require('jiff-js'); console.log(Timestamp.now().inTz('UTC').toString());

浏览器

使用 web 入口并配合打包器,在创建值之前先初始化:

import init, { Timestamp } from 'jiff-js/web'; await init(); console.log(Timestamp.now().inTz('Asia/Tokyo').toString());

加载器会相对于生成的模块获取 WASM。你的打包器或静态服务器必须保留或输出该资源。jiff-js/jiff.wasm 导出标识浏览器端二进制文件。当宿主管理资源时,传入 URL、Response、字节数据或已编译的 WebAssembly 模块:

await init('/assets/jiff.wasm'); // 或者:await init(wasmBytes);

重复初始化是安全的,初始化失败后可以重试。初始化之前调用会抛出 TypeError。要以流式编译方式提供 WASM,请使用 application/wasm 作为 MIME 类型。浏览器安全策略必须允许 WebAssembly 和获取该资源。现代浏览器需要 WebAssembly、bigint 和 Intl。其他运行时(包括边缘 worker)需要单独验证。

所有值都是不可变的。算术运算返回新值。无效输入会抛出 TypeError 或 RangeError。整数输入在传入 WASM 之前会先做检查。TypeScript 声明覆盖 Node 和浏览器入口。

每个类都有 from、toString、toJSON 和 equals。civil 命名空间提供 Date、Time 和 DateTime 别名,以及日期和时间构造辅助函数。tz.TimeZone 是 TimeZone 的别名。

const t = Timestamp.fromNanosecond(-1n); t.toString(); // '1969-12-31T23:59:59.999999999Z' t.asNanosecond(); // -1n t.asMicrosecond(); // 0n t.asMillisecond(); // 0

Epoch 工厂方法 fromSecond、fromMillisecond、fromMicrosecond 和 fromNanosecond 接受 bigint 或安全整数。asSecond 和 asMillisecond 返回 number;asMicrosecond 和 asNanosecond 返回 bigint。转换向零截断,包括 Unix 纪元之前的时间。Timestamp.now() 和 ZonedDateTime.now() 使用 JavaScript 时钟,精度为毫秒。解析和计算得到的值保留纳秒精度。Intl 发现系统时区;Jiff 内置数据提供所有时区规则。

import { CivilDate, CivilTime, CivilDateTime } from 'jiff-js'; const date = new CivilDate(2024, 2, 29); date.at(new CivilTime(12, 30, 0, 123456789)).toString(); // '2024-02-29T12:30:00.123456789' CivilDate.from({ year: 2024, month: 1, day: 31 }) .add({ months: 1 }).toString(); // '2024-02-29' CivilDateTime.from('2024-07-11T12:30').inTz('Europe/Paris');

数值构造函数在最后一个亚秒参数中接受完整的小数秒,范围为 0..999999999。字段记录使用独立的毫秒、微秒和纳秒字段,各字段范围为 0..999。日期记录需要 year、month 和 day;日期时间记录将这些与时间字段组合。Civil 字段是只读属性。星期使用 Monday = 1 到 Sunday = 7。日期可以通过 at(time) 或 at(hour, minute, second, subsecond) 组合。date.toDateTime(time) 和 time.toDateTime(date) 也能组合值。日期时间值暴露 date() 和 time()。inTz(zone, options) 显式地为 civil 日期或日期时间指定时区。

import { ZonedDateTime, CivilDateTime } from 'jiff-js'; const start = ZonedDateTime.from('2024-03-09T12:00-05:00[America/New_York]'); start.add({ days: 1 }).hour; // 12,仅过了 23 个实际小时 start.add({ hours: 24 }).hour; // 13 const fold = CivilDateTime.from('2024-11-03T01:30'); fold.inTz('America/New_York', { disambiguation: 'earlier' }).offset; // '-04' fold.inTz('America/New_York', { disambiguation: 'later' }).offset; // '-05'

Disambiguation 接受 compatible、earlier、later 或 reject。默认的 compatible 会选择较早的重复时间,并在时间间隙中向前移动。reject 在遇到间隙和重复时抛出异常。对于不含偏移的字符串,ZonedDateTime.from 也接受此选项。同时包含偏移和时区的字符串会拒绝冲突的偏移。

Zoned 值暴露 timestamp()、datetime()、date()、time()、timeZone() 和 inTz(zone)。更改时区会保留同一时刻。TimeZone.from 接受 IANA 名称和 Jiff 支持的固定偏移。TimeZone.UTC 和 TimeZone.system() 是便捷方式。偏移使用 Jiff 的简洁写法,例如 -04 或 +05:30。

const span = Span.new().hours(1).minutes(30); span.total('minute'); // 90 span.negated().toString(); // '-PT1H30M' const start = Timestamp.from('2024-01-01T00:00:00Z'); start.until(start.add(span), { largestUnit: 'hour' }).toString(); // 'PT1H30M' start.add({ seconds: 31 }).round('minute').toString(); // '2024-01-01T00:01:00Z'

Span 接受 ISO 持续时间字符串或使用复数单位名的记录。用 getYears() 到 getNanoseconds() 读取字段。微秒和纳秒接受 bigint,其 getter 返回 bigint;其他字段使用安全整数。拒绝混合符号。Span 相等性比较字段,因此 PT60M 和 PT1H 不同。abs() 和 negated() 保留字段。

日历总量计算需要参考值,例如 Span.from({ days: 1 }).total({ unit: 'hour', relativeTo: zonedValue })。与 Jiff 一样,总量返回浮点数。如需精确的经过整数,请使用 timestamp 纳秒。

日期时间值支持 add、subtract、until、since、equals 以及静态

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →