Jiff 0.2.0发布:Rust日期时间库的重大升级
Jiff是一个新兴的Rust日期时间处理库,它从JavaScript的Temporal API中汲取了大量灵感。作为一个现代化的日期时间库,Jiff提供了时区数据库的自动无缝集成、支持DST感知的算术运算和舍入操作、无损的时区感知日期时间格式化和解析,以及可选的Serde支持等丰富功能。Jiff的核心设计理念是引导开发者走向"成功之坑",让处理日期时间的代码更不容易出错。
重大变更概览
Jiff 0.2.0是一个语义化版本不兼容的发布,包含多项重大变更。虽然大多数现有用户应该能够无缝升级,但开发者仍需注意以下关键变化:
1. 移除危险的时间跨度比较
Span
类型移除了PartialEq
和Eq
特质实现,因为直接比较时间跨度容易导致微妙的错误。取而代之的是新增的Span::fieldwise()
方法,它会返回一个支持字段级比较的SpanFieldwise
类型。这一变更强制开发者显式表达比较意图,避免潜在问题。
2. 更精确的时间跨度处理
在时间跨度计算中,不再默认假设一天总是24小时。现在,对于涉及天或更大单位的操作,开发者必须提供相对日期或明确选择24小时制。例如,可以使用SpanRelativeTo::days_are_24_hours
或SpanTotal::days_are_24_hours
来保持向后兼容性。
3. 系统时区检测失败处理优化
当TimeZone::system()
无法检测到系统时区时,不再静默回退到UTC,而是使用特殊的Etc/Unknown
时区。这一变更使得时区检测问题更加显眼,同时仍保持系统继续运行。
生态系统集成增强
Jiff 0.2.0显著提升了与其他Rust生态系统的集成能力:
1. ICU4X集成
新增的jiff-icu
crate提供了与ICU4X项目的无缝集成,成为处理非公历日历和本地化日期时间的推荐方式。开发者可以轻松地在Jiff和ICU4X的日期时间类型间进行转换。
2. 数据库支持
jiff-sqlx
为SQLx提供了包装类型,支持PostgreSQL和SQLitejiff-diesel
为Diesel提供了包装类型,全面支持MySQL、PostgreSQL和SQLite
这些集成crate使得在数据库操作中使用Jiff类型变得更加便捷。
其他重要改进
-
时间跨度计算更安全:
Timestamp::saturating_add
现在会将潜在的panic转换为错误返回,提高了鲁棒性。 -
时区解析更严格:当解析到时间间隙(gap)时,现在会拒绝所有偏移量,与Temporal的行为保持一致。这有助于处理未来日期在夏令时规则变更前的序列化场景。
-
性能优化:
TimeZone::to_offset
被拆分为两个方法,在只需要偏移量的常见场景下减少了不必要的计算开销。 -
强制使用打包时区数据库:通过
tzdb-bundle-always
特性,开发者可以明确选择使用打包的IANA时区数据库,而不依赖系统提供的版本。
升级建议
对于大多数项目,升级到Jiff 0.2.0应该是相对直接的。主要需要注意:
- 替换所有使用
intz
的地方为in_tz
- 显式处理时间跨度比较,使用
fieldwise()
方法 - 对于涉及天或更大单位的时间跨度计算,提供相对日期或明确指定24小时制
- 检查系统时区检测失败的处理逻辑
Jiff作者计划在约6个月后发布1.0版本,届时将承诺长期稳定性。当前0.2.0版本为开发者提供了更安全、更强大的日期时间处理能力,同时为1.0的稳定API奠定了基础。
- DDeepSeek-V3.1-BaseDeepSeek-V3.1 是一款支持思考模式与非思考模式的混合模型Python00
- QQwen-Image-Edit基于200亿参数Qwen-Image构建,Qwen-Image-Edit实现精准文本渲染与图像编辑,融合语义与外观控制能力Jinja00
GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~042CommonUtilLibrary
快速开发工具类收集,史上最全的开发工具类,欢迎Follow、Fork、StarJava04GitCode百大开源项目
GitCode百大计划旨在表彰GitCode平台上积极推动项目社区化,拥有广泛影响力的G-Star项目,入选项目不仅代表了GitCode开源生态的蓬勃发展,也反映了当下开源行业的发展趋势。06GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00openHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!C0300- WWan2.2-S2V-14B【Wan2.2 全新发布|更强画质,更快生成】新一代视频生成模型 Wan2.2,创新采用MoE架构,实现电影级美学与复杂运动控制,支持720P高清文本/图像生成视频,消费级显卡即可流畅运行,性能达业界领先水平Python00
- GGLM-4.5-AirGLM-4.5 系列模型是专为智能体设计的基础模型。GLM-4.5拥有 3550 亿总参数量,其中 320 亿活跃参数;GLM-4.5-Air采用更紧凑的设计,拥有 1060 亿总参数量,其中 120 亿活跃参数。GLM-4.5模型统一了推理、编码和智能体能力,以满足智能体应用的复杂需求Jinja00
Yi-Coder
Yi Coder 编程模型,小而强大的编程助手HTML013
热门内容推荐
最新内容推荐
项目优选









