Jiff 1.0、Rustエコシステムに新たな日付・時刻モデルを提供
Andrew GallantがJiff 1.0をリリースしました。これはJavaScriptのTemporalに影響を受けたRustの日付・時刻ライブラリで、タイムゾーンの安全性とAPIの明確性を重視しています。
英語の原文から自動翻訳されました。
Andrew Gallantは、Rustプログラミング言語向けの新しい日付・時刻ライブラリ「Jiff」の1.0リリースを発表しました。このライブラリは、JavaScriptのTemporal提案に強く影響を受けた設計により、Rustエコシステムにおける長年の日付・時刻処理に関する混乱を解消することを目指しています。この安定版リリースは、これに依存するプロジェクトに対して長期的なAPI互換性へのコミットメントを示すものです。
何が起きたか
長年にわたり、Rust開発者は日付・時刻操作にchronoを使うべきかtimeを使うべきかを議論してきました。Gallant氏は、これらのライブラリはいずれも設計上の局所的な最適解(ローカルマックス)に達しており、破壊的変更なしには大幅な改善が難しい状況にあると指摘しました。彼は既存のAPI、特にローカル時間変換、システムタイムゾーンデータベース、カレンダー演算を扱う際に混乱が生じやすい点を見出していました。既存のメンテナに根本的に異なる方向性を受け入れるよう説得する代わりに、彼はドメインの複雑さをカプセル化し、ユーザーが正しい使い方へ導かれるようにJiffを構築しました。
バージョン1.0に到達する以前から、このライブラリは本番環境のツールで既に広く採用されています。uv、Cargo、Starship、fd、Nushell、mise、Jujutsu、uutils/coreutilsなどのプロジェクトが現在Jiffを使用しています。また、AWS LLRTにおけるTemporal実装の基盤としても機能しています。こうした広範な利用状況を踏まえ、Gallant氏はAPIを安定版として宣言し、重大な欠陥が見つからない限り、セマンティックバージョニング(semver)に非互換なリリースを行わないことを約束しました。この安定性は、Jiffをエコシステム内の他のライブラリにとって安全な公開依存関係にするために意図されたものです。
仕組み
Jiffは、日付・時刻処理を層状の構造(オニオンモデル)として表現します。単純な暦日付と時刻から始まり、完全にタイムゾーン付きの日時へと積み上がっていきます。最下層にはcivil::Dateとcivil::Timeがあり、これらは特定の場所に関連付けられていない素のグレゴリオ暦日付と時計時刻を表します。これらが組み合わさってcivil::DateTimeとなります。その上位層にはTimestampがあり、Unixエポックからのナノ秒数として、曖昧さのない瞬間を表します。最外層はZonedDateTimeであり、タイムスタンプ、暦日時、およびTimeZoneを組み合わせて、特定の地理地域における具体的な瞬間を表します。
このライブラリはJavaScriptのTemporal標準ライブラリから強い影響を受けており、そのAPI概念をRustのイディオムに翻訳しています。例えば、TemporalのDuration型は、Rustの標準ライブラリstd::time::Durationとの混同を避けるため、JiffではSpanと呼ばれています。同様に、TemporalのInstantはstd::time::Instantと区別するためにTimestampと呼ばれています。Temporalの暦型(Civil types)はJiffでも「civil」と呼ばれます。一対一の移植ではありませんが、Temporalに慣れ親しんだ開発者であれば、JiffのAPIを直感的に理解できるでしょう。 daylight saving time(夏時間)の移行などよくある落とし穴については、タイムゾーンのルールを設計の中心に置くことで自動的に処理されます。
主要な詳細
- Jiff 1.0は、エコシステムの構成要素としての役割を支えるため、無期限のAPI安定性にコミットしています。
- このライブラリの読み方は、「gif」のように柔らかい「g」の音で発音され、「gem」に近い響きです。
- Rust標準ライブラリの型名との競合を防ぐため、期間には
Span、瞬間にはTimestampという用語を使用しています。 - タイムゾーンは、
America/New_YorkやAsia/TokyoのようなIANAタイムゾーンデータベース識別子を用いて定義されます。 - 日付の丸め処理やカレンダー演算をサポートしており、特定の日付を基準にして期間を最も近い日に丸めるような操作が可能です。
- Jiffはグレゴリオ暦のみをサポートし、日付・時刻の範囲を+/- 9999年に制限しています。
なぜ重要なのか
日付・時刻処理は、コンピュータのシステム時間と人間の暦時間が交差する地点にあるため、エラーが発生しやすいことで知られています。システム時間はUnix時間に依存しますが、人間の時間はうるう秒、夏時間、地理的なオフセットといった複雑なルールを含みます。多くの既存ライブラリはこの複雑さを開発者に委ねるため、タイムスタンプとローカル時計の変換時にバグが生じます。Jiffはこの複雑さをカプセル化し、ユーザーが無効な操作を行ったり、タイムゾーンデータを誤解釈したりすることを困難にしようとしています。
クロスプラットフォームツールを構築する技術リードやエンジニアにとって、安定かつ適切にモデル化された日付・時刻ライブラリを持つことは、メンテナンス負担を軽減します。タイムゾーン移行時の曖昧さを防ぐ設計を採用することで、Jiffはチームが時計のずれに関連した微妙なバグを回避するのに役立ちます。主要なRustツールプロジェクトでの採用実績は、Jiffが新規Rustアプリケーションの事実上の標準になる可能性を示唆しており、従来chronoとtimeの間で生じていた断片化を解消することになります。
できること
- アナウンスメントに記載されているAPI例を試すために、Cargoプロジェクトに
jiffとanyhowを追加してください。 - JavaScriptの日付・時刻処理の経験がある場合は、Temporalの概念とJiffの型との対応関係をレビューしてください。
- Rustアプリケーション内のレガシーな日付・時刻ロジックをJiffの
ZonedDateTimeに置き換え、正しいタイムゾーン処理を保証してください。 - コードの可読性を向上させるため、手動での秒計算の代わりに
Span型をカレンダー演算に使用してください。 - 初期採用者である場合は、CHANGELOGを確認してJiff 0.2と1.0間の破壊的変更を理解してください。
- 公開依存関係において長期的なAPI安定性が要件となる新規プロジェクトでJiffの評価を検討してください。


