Outils de développement

Jiff 1.0 introduit un nouveau modèle de date et heure dans l'écosystème Rust

Andrew Gallant publie Jiff 1.0, une bibliothèque Rust de gestion des dates et heures inspirée de Temporal en JavaScript, qui privilégie la sécurité des fuseaux horaires et la clarté de l'API.

Un oignon en verre avec des éléments d'horloge flottant au-dessus d'un engrenage métallique, symbolisant la complexité stratifiée de la gestion des dates et heures dans Rust.
Illustration générée pour cet article

Traduit automatiquement depuis l'original anglais.

Andrew Gallant a annoncé la sortie de la version 1.0 de Jiff, une nouvelle bibliothèque de gestion des dates et heures pour le langage de programmation Rust. Cette bibliothèque vise à résoudre les confusions persistantes dans l'écosystème Rust concernant le traitement des dates et heures, grâce à une conception fortement inspirée de la proposition Temporal de JavaScript. Cette version stable marque un engagement envers une compatibilité API à long terme pour les projets qui en dépendent.

Ce qu'il s'est passé

Pendant des années, les développeurs Rust ont débattu sur l'utilisation de chrono ou time pour les opérations de date et heure. Gallant a noté que ces deux bibliothèques avaient atteint un maximum local dans leur conception, rendant les améliorations significatives difficiles sans modifications cassantes (breaking changes). Il trouvait les API existantes déroutantes, notamment lors de la conversion d'heures locales, de l'accès aux bases de données de fuseaux horaires du système et de l'arithmétique calendaire. Plutôt que d'essayer de convaincre les mainteneurs actuels d'adopter des directions radicalement différentes, il a créé Jiff pour encapsuler la complexité du domaine et guider les utilisateurs vers une utilisation correcte.

La bibliothèque a déjà connu une adoption substantielle dans des outils de production avant même d'atteindre la version 1.0. Des projets tels que uv, Cargo, Starship, fd, Nushell, mise, Jujutsu et uutils/coreutils utilisent actuellement Jiff. Elle sert également de base à une implémentation de Temporal dans AWS LLRT. Face à cette utilisation répandue, Gallant a déclaré l'API stable, promettant d'éviter les releases incompatibles avec semver sauf en cas de défauts critiques. Cette stabilité vise à faire de Jiff une dépendance publique sûre pour d'autres bibliothèques de l'écosystème.

Comment cela fonctionne

Jiff modélise la gestion des dates et heures comme un oignon composé de couches, partant des dates et heures civiles simples pour aller jusqu'aux dates et heures entièrement zonées. À la base se trouvent civil::Date et civil::Time, qui représentent des dates grégoriennes et des heures d'horloge brutes, non attachées à un lieu. Celles-ci se combinent en un civil::DateTime. Au-dessus de cette couche se trouve le Timestamp, qui représente un instant précis dans le temps sous forme de nanosecondes depuis l'epoch Unix. La couche la plus externe est le ZonedDateTime, qui combine un timestamp, une date/heure civile et un TimeZone pour représenter un moment spécifique dans une région géographique donnée.

La bibliothèque s'inspire fortement de la bibliothèque standard Temporal de JavaScript, traduisant ses concepts d'API dans les idiomes de Rust. Par exemple, le type Duration de Temporal est nommé Span dans Jiff pour éviter toute confusion avec std::time::Duration de la bibliothèque standard Rust. De même, l'Instant de Temporal est appelé Timestamp pour le distinguer de std::time::Instant. Les types civils de Temporal sont désignés par « civil » dans Jiff. Bien qu'il ne s'agisse pas d'une implémentation identique, Jiff permet aux développeurs familiers avec Temporal de trouver l'API intuitive. Elle gère automatiquement les pièges courants comme les transitions d'heure d'été/d'hiver en plaçant les règles de fuseau horaire au cœur de sa conception.

Détails clés

  • Jiff 1.0 s'engage à une stabilité API indéfinie pour soutenir son rôle de bloc de construction de l'écosystème.
  • Le nom de la bibliothèque se prononce comme « gif » avec un « g » doux, similaire au mot anglais « gem ».
  • Jiff utilise le terme Span pour les durées et Timestamp pour les instants afin d'éviter les conflits de noms avec les types de la bibliothèque standard Rust.
  • Les fuseaux horaires sont définis à l'aide des identifiants de la Base de Données des Fuseaux Horaires IANA, tels que America/New_York ou Asia/Tokyo.
  • La bibliothèque prend en charge l'arrondi des dates et l'arithmétique calendaire, permettant des opérations comme l'arrondi d'une durée (span) au jour le plus proche par rapport à une date spécifique.
  • Jiff ne prend en charge que le calendrier grégorien et limite sa plage de dates/heures à +/- 9999 ans.

Pourquoi c'est important

La gestion des dates et heures est notoirement sujette aux erreurs car elle se situe à l'intersection du temps système informatique et du temps civil humain. Le temps système repose sur le temps Unix, tandis que le temps humain implique des règles complexes telles que les secondes intercalaires, l'heure d'été et les décalages géographiques. De nombreuses bibliothèques existantes transmettent cette complexité au développeur, entraînant des bugs lors de la conversion entre timestamps et horloges locales. Jiff tente d'encapsuler cette complexité, rendant difficile pour les utilisateurs d'effectuer des opérations invalides ou d'interpréter incorrectement les données de fuseau horaire.

Pour les responsables techniques et les ingénieurs développant des outils multiplateformes, disposer d'une bibliothèque de dates et heures stable et bien modélisée réduit la charge de maintenance. En adoptant une conception qui empêche les ambiguïtés lors des transitions de fuseau horaire, Jiff aide les équipes à éviter des bugs subtils liés aux changements d'horloge. Son adoption par des projets majeurs de l'outillage Rust suggère qu'elle pourrait devenir le standard de facto pour les nouvelles applications Rust, réduisant la fragmentation causée par le choix précédent entre chrono et time.

Ce que vous pouvez faire

  • Ajoutez jiff et anyhow à votre projet Cargo pour tester les exemples d'API fournis dans l'annonce.
  • Examinez la correspondance entre les concepts Temporal et les types Jiff si vous avez de l'expérience avec la gestion des dates et heures en JavaScript.
  • Remplacez la logique de date/heure héritée dans vos applications Rust par le ZonedDateTime de Jiff pour garantir une gestion correcte des fuseaux horaires.
  • Utilisez le type Span pour l'arithmétique calendaire plutôt que des calculs manuels de secondes afin d'améliorer la lisibilité du code.
  • Consultez le CHANGELOG pour comprendre les modifications cassantes entre Jiff 0.2 et 1.0 si vous êtes un utilisateur précoce.
  • Évaluez Jiff pour les nouveaux projets où la stabilité API à long terme est une exigence pour les dépendances publiques.
  • #rust
  • #datetime
  • #software engineering
  • #libraries
  • #temporal

Outils de la Boutique Bytechap

Continuer la lecture

Tous les articles