未来を形作るテクノロジーの深掘り記事。

Jiff vs Chrono:Rustの日時ライブラリ比較

Jiff vs Chronoを比較。DSTの曖昧さ、API設計、どちらを選ぶべきかを、両方で痛い目を見た筆者の視点で解説します。

重なり合う2つの時計の図。機械式と有機的な意匠で、タイムゾーンの切り替わりを表現しています。
日時のバグは、たいてい何かがクラッシュするわけではありません。ただ静かに間違った時刻を返してくるだけです。

数年に一度、「ニューヨークの2026-11-01 01:30」が2回存在することに気づき、スケジューラが課金ジョブを1時間早く実行してしまった……という不運なエンジニアが現れます。日時のバグはプログラムをクラッシュさせることはなく、静かにデータを壊していきます。だからこそ、ripgrepの作者として知られるAndrew Gallantが開発したRustの新しい日時ライブラリJiff 1.0の登場は、単なるクレートのリリース以上の意味を持ちます。次のRustプロジェクトでJiffとchronoのどちらを使うべきか、という本質的な問いを突きつけてくるからです。

Rustの日時処理にまつわる苦労の歴史

Rustではこれまでも同じ問題が繰り返されてきており、その歴史は示唆に富みます。chronoは言語がまだ1.0になる前の時代に生まれ、「標準ライブラリを適正なサイズにする」大規模な整理の一環として、timeクレートとともに標準ライブラリから切り出されました。ほぼ10年にわたって事実上のデフォルトの選択肢でした。概ね問題なく動いていたのです。しかし、そのAPIは層を重ねていきました。NaiveDateTime、DateTime<Utc>、DateTime<Local>、DateTime<FixedOffset>、そして多くの人が2つの実装を通してしか触れないTimeZoneトレイトです。型システムは、ナイーブな日時にゾーン付きの日時を足すといった、意味的にはおかしい操作も許してしまい、その結果、自信満々で間違った答えが返ってきました。

メンテナンスの状況も重要です。chronoは実質的に放置された時期があり、その後のメンテナーたちも、ユーザーが神聖視するAPIの安定性と戦うような経験だったと語っています。ある元メンテナーは率直にこう述べました。改善に向けた小さな一歩はどれも抵抗に遭った、chronoの最大の売りは設計ではなく安定性になってしまっていた、と。これは長く使われるライブラリがはまりがちな罠で、インストールベースそのものがプロダクトになってしまうのです。timeクレートはよりクリーンなコアで別のアプローチを試みましたが、長年にわたり完全なタイムゾーン処理は後回しにしていました。一方で、「来年3月のベルリンは何時か」が根幹にかかわる問いであるアプリケーションは、エコシステムの中で増え続けていました。

これはJiffが、名言するかどうかは別として、拠り所としている古い考え方です。2000年代半ばにRico Marianiが API設計について語った「pit of success(成功の穴)」の哲学です。簡単な道を正しい道にする、ということです。Gallantの見方では、日時の難しさは不適切なドメインモデリングから来ており、「ナイーブな日時をどうぞ、頑張ってください」のように曖昧さをユーザーに押し付けるライブラリは、最も難しい問題を外注しているにすぎません。これはRustの所有権モデルと同じ発想でもあります。複雑さは機械が吸収し、人間がそれを背負わなくて済むようにするのです。

JiffによるTimeのモデリング:玉ねぎ構造

Jiffの中心的な設計は、Gallantが「日時の玉ねぎ(datetime onion)」と呼ぶものです。内側から外側へ、層は次のとおりです。

  • civil::Date:場所を持たないグレゴリオ暦の日付。誕生日はこれにあたります。
  • civil::Time:ナノ秒精度の壁時計の時刻。場所は持ちません。
  • civil::DateTime:日付と時刻を合わせたもの。やはり場所は持ちません。chronoでいうnaiveにあたります。
  • Timestamp:曖昧さのない瞬間を表す、UNIXエポックからのナノ秒数。
  • TimeZone:ある地域における瞬間と市民時刻(civil time)の対応ルール。
  • ZonedDateTime:瞬間、市民時刻、ゾーンをすべてまとめたもの。

この設計の利点は、型の名前が既にみなさんの頭の中にあるメンタルモデルと一致することです。Timestampはデータベースやシステムコールから得られるもの、civil::DateTimeは人間がカレンダーの招待に書き込むものです。タイムゾーンなしでこの2つを変換することはできず、Jiffではその変換が明示的で、失敗しうる、ゾーンを明記した操作になります。chronoにも同様の区別はありますが、混同しやすくなっています。たとえばNaiveDateTime::and_utc()は、その壁時計の時刻が実在したかどうかを問うことなく、喜んでゾーンを割り当ててしまいます。

使い勝手は意図的に穏やかに設計されています。ゾーン付き日時は、市民時刻+ゾーン、あるいはタイムスタンプ+ゾーンのどちらの方向からでも作れ、APIはそのどちらにも対応しています。

use jiff::civil;
fn main() -> anyhow::Result<()> {
// Start from what a human would write on a calendar.
let dt = civil::date(2026, 11, 1).at(17, 30, 0, 0);
let zdt = dt.in_tz("America/New_York")?;
assert_eq!(zdt.offset().seconds(), -(5 * 60 * 60));
// Arithmetic on the civil parts stays civil:
let tomorrow = zdt.date().tomorrow()?;
assert_eq!(tomorrow, civil::date(2026, 11, 2));
Ok(())
}

夏時間(DST):Jiffの真価が発揮される場面

ここで、日時ライブラリの設計で大人と子供を分けるシナリオを見てみましょう。2026年11月1日、ニューヨークの時計は午前2時に1時間戻ります。そのため午前1時台が2回訪れます。では、ユーザーが「11月1日の午前1時30分」と入力したら、どうすればよいでしょうか。chronoの従来の答えはLocalResultでした。これはSingle、Ambiguous、Noneのいずれかになる列挙型で、驚くほど多くの本番コードが、これを雑にunwrapしたり、捨てたり、誤ってパターンマッチしたりしています。曖昧さは露出されていますが、それを毎回処理する負担もそのまま開発者に残ります。

Jiffの答えは、妥当なデフォルトを選び、代替案は1回のメソッド呼び出しで済むようにすることです。デフォルトの「compatible」戦略では、重複した時刻は先に現れた方に解決されます。これは多くのカレンダーソフトや主要なOSの振る舞いと一致しています。ただし、こだわりがあるなら、判断のための全体像がそこに用意されています。

use jiff::{civil::date, tz::TimeZone};
fn main() -> anyhow::Result<()> {
let tz = TimeZone::get("America/New_York")?;
let dt = date(2026, 11, 1).at(1, 30, 0, 0);
let amb = tz.to_ambiguous_zoned_datetime(dt);
let earlier = amb.earlier()?;  // offset -04 (EDT), first 1:30
let later = amb.later()?;      // offset -05 (EST), second 1:30
// Or refuse to guess entirely:
assert!(tz.to_ambiguous_zoned_datetime(dt).unambiguous().is_err());
Ok(())
}

ギャップ(欠落)も同様に扱われます。時計が進んで午前2時30分が存在しないとき、Jiffはデフォルトで前方に寄せますが、ここでもまた上書きできます。ここでの設計判断は意見の分かれるものですが、私の考えでは正しいと思います。曖昧な時刻を扱うほとんどのコードには方針がなく、あるのは11月を待っているバグだけです。ユーザーがスマートフォンで既に期待している振る舞いをデフォルトにしつつ、抜け道は見えるように型付きで用意しておく。それこそが実際の「pit of success」の意味です。これは、手書きの日付計算で良いデフォルトを選ぶ考え方とも似ています。ルールは学べますが、呼び出し箇所のたびにそれを導き直す必要はないはずです。

抽象的なリボン状のタイムラインで、戻って重なる箇所(フォールド)と途切れる箇所(ギャップ)を示した図。
フォールドとギャップ:市民時刻が瞬間に明確に対応しなくなる2つの箇所。

期間(Span)とDuration、そして「1か月」問題

chronoに「1か月」という期間を尋ねると、がっかりするでしょう。そのDurationは固定の秒数だからです。1か月は何か固定の数で表せるものではないのです。これは筋の通った設計ですが、「1月31日に3か月足す」といったカレンダー計算は利用者側の問題になります。JiffのSpan型は別の道を選びます。年からナノ秒まで、異なる単位を混在して保持でき、演算はカレンダーを意識した形で解決されます。1月31日に1か月足すと、3月3日ではなく2月28日(うるう年なら29日)になります。夏時間の切り替えの前夜にゾーン付き日時へ1日足すと、暦上の1日が加算されるため、その日の長さは23時間または25時間になりえます。これこそ、人が「明日の同じ時刻に」と言うときに意味していることです。

この区別、つまり経過時間とカレンダー上の時間の違いは、日時プログラミングで最も混同されている概念であり、どこでも混同されています。Javaの元のjava.util.Dateは両者を混ぜていました。Java 8のjava.timeパッケージ(Joda-Timeをもとにしたもの)はDurationとPeriodを分離し、その結果は明らかに良いものでした。JavaScriptのTemporal提案も同じ分離を行っています。Jiffはこの系譜にきちんと位置づけられます。日時設計の良いアイデアは20年かけて収束してきており、Jiffはその合意をRustで表現したものと言えます。これは、長く温められてきたRustの言語機能が、10年分の議論を経て洗練された形で登場するのとよく似ています。

「分かりやすい」期間の書式もあります。2h 30mやP1DT2Hのような文字列が自然に解析・出力されます。さらにstrptime/strftime形式の書式指定、そしてロケールに配慮した出力のための任意のICU4X連携もあります。これらは当たり前の機能に聞こえますが、ログパイプライン用に独自のchrono書式文字列を書いたことがある人なら、どれほど手間が省けるかわかるはずです。

Jiff vs Chrono:それぞれが勝つ場面

ツアーはこのくらいにして、ここからは意見を添えた率直な比較をします。

chronoが依然として有利な場面

慣性も一つの機能です。chronoはRustエコシステムの非常に多くのプロジェクトの依存関係に含まれ、数えきれないほどの公開APIに登場し、信頼できる体制で保守されています。コードベースがすでにchronoに精通していて、タイムスタンプがUTCのみの瞬間(メトリクスパイプライン、ログのエンベロープ、内部RPCなど)であり、チームがchronoの鋭い癖を把握しているなら、移行で得られるものは多くありません。chronoのstdを任意にでき、no_stdにも適した設計は、組み込みの領域でも依然として重要です。また、メガイヤー規模の軌道力学や、TAIやUT1のような代替時間系など、特殊な用途であれば、どちらのライブラリも本当の答えにはなりません。文字列の解析のためにどちらかをラップし、独自の表現を保つことになるでしょう。その際には、端のシンプルさを持つchronoで十分です。

実務者から聞いたことのある、正当な反論もあります。chronoの明示性を好む人が実際にいるのです。LocalResult::Ambiguousは、考えることを強制します。ドメインがDSTの重複時刻を推測で誤ると法的・金銭的な影響が出る分野、たとえば給与計算、電力の決済、取引などであれば、ライブラリにいつでも推測を拒否させたいと思うかもしれません。Jiffはunambiguous()でそれを実現できますが、chronoではそれが最も抵抗の少ない道になっています。それも一理あります。

Jiffが勝つ場面

それ以外のほとんどの場面です。スケジューリング、カレンダー、ユーザー向けの日付、タイムゾーンをまたぐものなど、市民時刻に触れるアプリケーションはどれも、Jiffを使うことで明らかに得をします。型の名前がドメインを教えてくれます。DSTの曖昧さには妥当なデフォルトと型付きの抜け道が用意されており、午前2時に間違えて処理してしまう列挙型は不要です。Spanは最初からカレンダー計算を正しく行います。解析と書式設定は、人間が実際に書く分かりやすい形式をカバーしています。そして1.0としての約束も重要です。Gallantは、Jiffを他のライブラリの公開APIに組み込めるように、APIを無期限に安定させる意図を明言しています。これはまさに、chronoの過ちを恒久化させてしまった性質の裏返しです。採用実績もその野心を裏付けています。uv、Cargo、Starship、fd、Nushell、Jujutsu、uutilsがすべてJiffを使用しており、AWSのLLRTはJiffの上にTemporalの実装を構築しています。

パフォーマンスの話も、必ず聞かれるので触れておきます。両ライブラリとも十分に高速で、日時処理がボトルネックになることはまずありません。Jiffは、IANA tzデータベースを圧縮したコピーを同梱しており(rearguard tzdataの利用について、文書化された慎重な姿勢があります)、またシステムのゾーンデータベースを使うこともできます。この領域では正しさがマイクロベンチマークの数値を大きく上回るため、速度で選ぶのは職務怠慢と言えるでしょう。50ナノ秒で出した答えも、間違っていれば間違いです。

あらゆる場所で曖昧さを処理させる日時ライブラリは、より誠実なわけではありません。最も難しい問題を、最も解決する準備がない人、つまり急いでいる呼び出し箇所にいるあなたに丸投げしているだけです。

API設計にとってのより大きな教訓

日付の話を脇に置くと、Jiffは広い主張の事例研究でもあります。ライブラリはドメインの複雑さを忠実に再輸出するのではなく、カプセル化すべきだ、という主張です。IANAタイムゾーンデータベースは、批判者が正しく指摘するように、プログラマ向けの成果物です。場所ベースで、歴史的に網羅的で、ユーザーなら決して入力しないような識別子に満ちています。怠惰なライブラリはそれをそのまま露出させ、柔軟性と呼びます。良いライブラリはそれを吸収します。デフォルトの曖昧さ解消戦略、分かりやすい解析、人間の概念に対応する型名などです。他の領域でも同じ緊張が見られます。仕様と使える実装のあいだのギャップこそ多くのバグが生まれる場所であり、日時処理はそのギャップの典型的な生息地です。

エコシステムの忍耐の物語でもあります。Rustは「決定版」の日時ライブラリを得るまでに10年待ちました。非同期処理が落ち着くのを待ち、never型が安定化するのを待ったのと同じです。その待ち時間は、最初に動いた草稿に固定してしまわず、正しいモデルを得るためのコストです。chronoは失敗ではありませんでした。当時のエコシステムが必要としていた草稿だったのです。ただ、草稿は改訂されるものです。

おすすめ

新規のRustプロジェクトなら、Jiffを使いましょう。深く悩む必要はありません。APIが優れており、DSTの扱いがデフォルトで安全で、1.0の安定性の約束が明示されており、そしてエコシステムの勢い(Cargoやuvは簡単にクレートを採用しません)があるため、いずれにせよ目にする機会が増えるはずです。ユーザー向けの用途にはZonedDateTime、保存やワイヤーフォーマットにはTimestamp、場所が本当に関係ない場合はcivil系の型を使いましょう。

既存のchronoコードベースが問題なく動いているなら、そのまま使い続けましょう。ただし、市民時刻を多用する機能に触れており、chronoの落とし穴が実際にコストになっている場合は別です。2つのライブラリはタイムスタンプとISO文字列を通じてよく相互運用できるため、スケジューリングのモジュールだけJiffを使い、それ以外はchronoのままという部分的な導入は、妥協ではなく正当な戦略です。

どちらを選ぶにせよ、最後に覚えておきたいことがあります。日時処理が難しいのは、その領域が本質的に奇妙だからです。うるう秒、フォールド、ギャップ、長さの変わる月、法令で変更される政治的なタイムゾーンなどがあります。ライブラリにできる最善のことは、正しいデフォルトを選び、物事を誠実に命名し、抜け道を手の届くところに置いておくことです。Jiffはこの3つすべてを実現しています。Joda-Timeからjava.timeを経てTemporalに至る20年にわたる日時ライブラリの進化が、同じモデルに収束したのには理由があります。ようやくRustもそのバージョンを手に入れたのを見るのは、嬉しいことです。