Présentation de Jiff 1.0
Jiff atteint la version 1.0, une étape décisive pour la bibliothèque datetime de Rust. L’auteur affirme un engagement à long terme : aucune rupture de compatibilité majeure ne sera introduite tant qu’aucun défaut critique n’est découvert. Cette promesse vise à rendre Jiff un bloc de construction fiable pour les API publiques d’autres crates, limitant les douleurs liées aux changements de version sémantique.
Architecture en couches
Le modèle de Jiff s’articule autour d’une métaphore d’oignon. Au centre se trouve Timestamp, un instant exprimé en nanosecondes depuis l’époque Unix, garantissant une résolution de nanosecondes. Autour, les types civil::Date et civil::Time représentent respectivement une date du calendrier grégorien et une heure de montre, tous deux dépourvus de contexte géographique. Leur combinaison forme civil::DateTime. La couche supérieure introduit TimeZone, un ensemble de règles de conversion entre Timestamp et civil::DateTime. Enfin, ZonedDateTime fusionne les trois, offrant un instant précis dans un fuseau horaire donné.
Gestion explicite des fuseaux et de l’heure d’été
Contrairement à de nombreuses bibliothèques qui laissent le développeur gérer les décalages, Jiff place le traitement des fuseaux horaires au cœur de l’API. Les exemples montrent deux voies d’obtention d’un ZonedDateTime : à partir d’une date civile + heure + identifiant IANA, ou à partir d’un Timestamp + même identifiant. Dans les deux cas, la fonction in_tz résout automatiquement les règles d’heure d’été, évitant les erreurs de calcul manuel. Le résultat est vérifié par assert_eq!, démontrant la reproductibilité du mapping.
Adoption et impact sur l’écosystème Rust
Jiff est déjà intégré dans des projets majeurs : uv, Cargo, Starship, fd, Nushell, mise, Jujutsu, uutils/coreutils et même comme base d’une implémentation Temporal dans AWS LLRT. Cette diffusion montre que la bibliothèque a satisfait les exigences de production, notamment la stabilité d’API et la prise en charge fiable des fuseaux. En garantissant une version 1.0 « indéfiniment », les mainteneurs de ces projets peuvent déclarer Jiff comme dépendance publique sans craindre de ruptures majeures, ce qui renforce la cohérence du paysage Rust autour de la manipulation du temps.
use jiff::civil;
fn main() -> anyhow::Result<()> {
let date = civil::date(2026, 11, 1);
let time = civil::time(17, 30, 0, 0);
let datetime = date.to_datetime(time);
let zdt = datetime.in_tz("America/New_York")?;
assert_eq!(zdt.timestamp().as_second(), 1793572200);
Ok(())
}
use jiff::{civil, Timestamp};
fn main() -> anyhow::Result<()> {
let timestamp = Timestamp::from_second(1793572200)?;
let zdt = timestamp.in_tz("America/New_York")?;
let expected = civil::date(2026, 11, 1).at(17, 30, 0, 0);
assert_eq!(zdt.datetime(), expected);
Ok(())
}