搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

BurntSushi/jiff

开发工具

面向 Rust 的日期时间库,提供时区感知运算、解析与格式化,让常见的日期处理错误更难发生。

3,200
141
Rust
Unlicense
创建于 2 年前

项目介绍

Jiff 是一个 Rust 日期时间库,目标是让正确的时间处理成为默认路径:提供不易误用的高层日期时间原语,同时保持作者所称的合理性能。它支持通过 Time Zone Database 处理 IANA 时区、DST 感知的运算与舍入、带时区日期时间的无损格式化与解析,以及可选的 Serde 支持。API 大量借鉴 JavaScript 的 TC39 Temporal 提案 README。

它适合需要在多个时区之间表示时间点、民用日期、时间跨度与带时区日期时间的 Rust 应用,尤其是对 DST 切换或序列化正确性敏感的场景。仓库还提供 API 设计说明,以及与 chrono、time、hifitime、icu 的对比,便于在多个 crate 之间做选择 设计说明,对比文档。

快速使用

先安装 Rust,然后在已有 crate 中加入依赖:

cargo add jiff

解析一个 RFC 3339 时间点,转换到指定时区,加上一段时间跨度,并无损打印:

use jiff::{Timestamp, ToSpan};

fn main() -> Result<(), jiff::Error> {
    let time: Timestamp = "2024-07-11T01:14:00Z".parse()?;
    let zoned = time.in_tz("America/New_York")?.checked_add(1.month().hours(2))?;
    assert_eq!(zoned.to_string(), "2024-08-10T23:14:00-04:00[America/New_York]");
    assert_eq!(zoned.timestamp().to_string(), "2024-08-11T03:14:00Z");
    Ok(())
}

如果要新建项目,README 给出了 cargo new、cargo add jiff、编写 src/main.rs、cargo run 的完整流程,运行后打印带 IANA 标识的当前时区时间 README。更多示例见 API 文档。

使用约束

  • 最低支持的 rustc 版本为 1.85.0;MSRV 提升只发生在次版本,且不视为 semver 不兼容变更 README。
  • 在 Unix 上,时区切换数据来自系统 IANA 数据库(通常在 /usr/share/zoneinfo,可用 TZDIR 环境变量指定),系统时区从 /etc/localtime 读取。在 Windows 上会内嵌一份时区数据库,并通过 CLDR 数据把 Windows 时区标识映射为 IANA 标识 README,平台说明。
  • crate features 控制 std 支持、Serde 支持以及是否内嵌时区数据库,完整列表见 crate features 文档。
  • 性能目标排在 API 清晰与正确性之后;部分路径做过优化,部分尚未优化,基准测试位于 bench 目录 README。
  • 采用 MIT 或 Unlicense 双许可 README。

HotRepo 点评

在 2024 年 7 月的 Hacker News 讨论中(448 分、241 条评论),讨论重点不在原始速度,而在 API 设计和时区处理的深度。有读者把设计文档视为「日期时间库没那么简单」的证据,并点出 DST 感知运算、可舍入的时间跨度和 Serde 往返等实质内容 评论;另一位读者把动机概括为 API 与 IANA 时区支持 评论。流式的 ToSpan 写法被批评为首个数字与方法参数混用,读者也给出了替代写法 评论,评论。2026-11-17 的 Rust 日榜快照记录 Jiff 位列第一、当日新增 61 星,说明项目在最初发布讨论之后仍持续获得关注。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

Hacker News 讨论

Jiff: Datetime library for Rust
▲ 448 · 241 条评论 · 2024年7月22日

相关推荐

  1. abseil/abseil-cpp一套 C++17 公共库,在标准库之外补充容器、字符串、日志、同步等经生产验证的组件,适合 C++ 开发者直接引用。C++18,196
  2. rust-lang/rustRust 语言的编译器、标准库与文档主源码仓库,适合使用或参与开发 Rust 的开发者。Rust121,159
  3. makepad/relax用 Rust 写的实时编译器与 JIT 运行时,直接从源码运行 Cargo 包,并在运行时热更新改动函数。Rust100
  4. NVIDIA/cuda-rust用 Rust 编写并运行 CUDA GPU kernel,可选择张量式 Tile 或底层 SIMT 两种编程模型。Rust3,866
  5. bendlang/bend一门带快速证明检查器的依类型语言,目标是让 AI 写的代码可被机器证明检验。TypeScript24,116