Entwicklerwerkzeuge

Jiff 1.0 bringt ein neues Datums- und Zeitmodell in das Rust-Ökosystem

Andrew Gallant veröffentlicht Jiff 1.0, eine Rust-Bibliothek für Datum und Uhrzeit, die sich an JavaScripts Temporal orientiert und Wert auf Zeitzonen-Sicherheit und API-Klarheit legt.

Eine Glaszwiebel mit Uhrzeitelementen, die über einem Metallzahnrad schwebt, symbolisiert die geschichtete Komplexität von Datum und Uhrzeit in Rust.
Für diesen Artikel generierte Illustration

Automatisch aus dem englischen Original übersetzt.

Andrew Gallant hat die Veröffentlichung von Jiff 1.0 angekündigt, einer neuen Bibliothek für Datum und Uhrzeit für die Programmiersprache Rust. Die Bibliothek zielt darauf ab, die langjährigen Verwirrungen im Rust-Ökosystem bezüglich der Handhabung von Datum und Uhrzeit zu lösen, indem sie ein Design bietet, das stark vom Temporal-Vorschlag aus JavaScript inspiriert ist. Diese stabile Version markiert ein Bekenntnis zur langfristigen API-Kompatibilität für Projekte, die davon abhängen.

Was passiert ist

Seit Jahren diskutieren Rust-Entwickler darüber, ob sie chrono oder time für Datums- und Zeitoperationen verwenden sollen. Gallant stellte fest, dass beide Bibliotheken in ihrem Design ein lokales Maximum erreicht hatten, was bedeutende Verbesserungen ohne Breaking Changes schwierig machte. Er empfand die bestehenden APIs als verwirrend, insbesondere bei der Umrechnung in lokale Zeiten, beim Zugriff auf System-Zeitzonendatenbanken und bei Kalenderarithmetik. Anstatt zu versuchen, bestehende Maintainer dazu zu überreden, radikal andere Richtungen einzuschlagen, entwickelte er Jiff, um die Domänenkomplexität zu kapseln und Nutzer zu korrekter Verwendung zu führen.

Die Bibliothek wurde bereits vor dem Erreichen der Version 1.0 umfangreich in Produktions-Tools eingesetzt. Projekte wie uv, Cargo, Starship, fd, Nushell, mise, Jujutsu und uutils/coreutils nutzen derzeit Jiff. Sie dient zudem als Grundlage für eine Temporal-Implementierung in AWS LLRT. Angesichts dieser weiten Verbreitung erklärte Gallant die API für stabil und versprach, semver-inkompatible Releases zu vermeiden, es sei denn, es werden kritische Fehler gefunden. Diese Stabilität soll Jiff zu einer sicheren öffentlichen Abhängigkeit für andere Bibliotheken im Ökosystem machen.

Wie es funktioniert

Jiff modelliert die Handhabung von Datum und Uhrzeit als Schalenmodell (Onion-Layer), beginnend mit einfachen bürgerlichen Daten und Zeiten und aufbauend bis hin zu vollständig zonierten Datums- und Zeitwerten. An der Basis stehen civil::Date und civil::Time, die reine gregorianische Daten und Uhrzeiten darstellen, die keinem Ort zugeordnet sind. Diese kombinieren sich zu einem civil::DateTime. Über dieser Ebene liegt der Timestamp, der einen eindeutigen Zeitpunkt als Nanosekunden seit der Unix-Epoche darstellt. Die äußerste Ebene ist der ZonedDateTime, der einen Timestamp, ein bürgerliches Datum/Uhrzeit und eine TimeZone kombiniert, um einen bestimmten Moment in einer bestimmten geografischen Region darzustellen.

Die Bibliothek lässt sich stark von der JavaScript-Temporal-Standardbibliothek inspirieren und übersetzt deren API-Konzepte in Rust-Idiome. Beispielsweise wird der Duration-Typ von Temporal in Jiff als Span bezeichnet, um Verwechslungen mit dem std::time::Duration der Rust-Standardbibliothek zu vermeiden. Ebenso wird Temporal’s Instant als Timestamp bezeichnet, um ihn von std::time::Instant zu unterscheiden. Bürgerliche Typen in Temporal werden in Jiff als "civil" bezeichnet. Obwohl es keine eins-zu-eins-Implementierung ist, ermöglicht Jiff Entwicklern, die mit Temporal vertraut sind, die API als unkompliziert zu empfinden. Sie behandelt häufige Fallstricke wie Übergänge zur Sommerzeit automatisch, indem sie Zeitzonenregeln in den Mittelpunkt ihres Designs stellt.

Wichtige Details

  • Jiff 1.0 verpflichtet sich zu unbefristeter API-Stabilität, um seine Rolle als Baustein des Ökosystems zu unterstützen.
  • Der Name der Bibliothek wird wie "gif" mit weichem "g" ausgesprochen, ähnlich dem Wort "gem".
  • Jiff verwendet den Begriff Span für Dauerangaben und Timestamp für Zeitpunkte, um Namenskonflikte mit Typen der Rust-Standardbibliothek zu verhindern.
  • Zeitzonen werden unter Verwendung von IANA Time Zone Database Identifiern definiert, wie z. B. America/New_York oder Asia/Tokyo.
  • Die Bibliothek unterstützt Datumsrundungen und Kalenderarithmetik, was Operationen wie das Runden einer Spanne auf den nächsten Tag relativ zu einem bestimmten Datum ermöglicht.
  • Jiff unterstützt nur den gregorianischen Kalender und begrenzt seinen Datums-/Zeitbereich auf +/- 9999 Jahre.

Warum das wichtig ist

Die Handhabung von Datum und Uhrzeit ist bekanntlich fehleranfällig, da sie an der Schnittstelle zwischen der Systemzeit des Computers und der menschlichen bürgerlichen Zeit liegt. Die Systemzeit basiert auf der Unix-Zeit, während die menschliche Zeit komplexe Regeln wie Schaltsekunden, Sommerzeit und geografische Verschiebungen umfasst. Viele bestehende Bibliotheken geben diese Komplexität an den Entwickler weiter, was zu Fehlern bei der Konvertierung zwischen Timestamps und lokalen Uhren führt. Jiff versucht, diese Komplexität zu kapseln, sodass es für Benutzer schwierig wird, ungültige Operationen durchzuführen oder Zeitzonendaten falsch zu interpretieren.

Für technische Leiter und Ingenieure, die plattformübergreifende Tools entwickeln, reduziert eine stabile, gut modellierte Datums- und Zeitbibliothek den Wartungsaufwand. Durch die Übernahme eines Designs, das Mehrdeutigkeiten während Zeitzonenübergängen verhindert, hilft Jiff Teams dabei, subtile Fehler im Zusammenhang mit Uhrverschiebungen zu vermeiden. Die Adoption durch große Rust-Tooling-Projekte deutet darauf hin, dass sie zum De-facto-Standard für neue Rust-Anwendungen werden könnte, was die Fragmentierung reduziert, die durch die bisherige Wahl zwischen chrono und time verursacht wurde.

Was Sie tun können

  • Fügen Sie jiff und anyhow zu Ihrem Cargo-Projekt hinzu, um die API-Beispiele aus der Ankündigung zu testen.
  • Prüfen Sie die Zuordnung zwischen Temporal-Konzepten und Jiff-Typen, wenn Sie Erfahrung mit der Datums- und Zeitbehandlung in JavaScript haben.
  • Ersetzen Sie veraltete Logik für Datum und Uhrzeit in Ihren Rust-Anwendungen durch Jiffs ZonedDateTime, um eine korrekte Zeitzonenbehandlung sicherzustellen.
  • Verwenden Sie den Span-Typ für Kalenderarithmetik anstelle manueller Sekundenberechnungen, um die Lesbarkeit des Codes zu verbessern.
  • Konsultieren Sie das CHANGELOG, um die Breaking Changes zwischen Jiff 0.2 und 1.0 zu verstehen, wenn Sie ein Early Adopter sind.
  • Bewerten Sie Jiff für neue Projekte, bei denen langfristige API-Stabilität eine Anforderung für öffentliche Abhängigkeiten ist.
  • #rust
  • #datetime
  • #software engineering
  • #libraries
  • #temporal

Tools aus dem Bytechap-Shop

Weiterlesen

Alle Artikel