Jiff 1.0 introduce un nuevo modelo de fecha y hora en el ecosistema Rust
Andrew Gallant lanza Jiff 1.0, una biblioteca de fechas y horas para Rust inspirada en Temporal de JavaScript que prioriza la seguridad de las zonas horarias y la claridad de la API.
Traducido automáticamente del original en inglés.
Andrew Gallant ha anunciado la versión 1.0 de Jiff, una nueva biblioteca de fechas y horas para el lenguaje de programación Rust. La biblioteca busca resolver la confusión histórica en el ecosistema Rust sobre el manejo de fechas y horas mediante un diseño fuertemente inspirado en la propuesta Temporal de JavaScript. Esta versión estable marca un compromiso con la compatibilidad a largo plazo de la API para los proyectos que dependen de ella.
Qué ha ocurrido
Durante años, los desarrolladores de Rust han debatido si usar chrono o time para operaciones de fecha y hora. Gallant señaló que ambas bibliotecas habían alcanzado un máximo local en su diseño, lo que hacía difícil realizar mejoras significativas sin introducir cambios incompatibles. Encontró las APIs existentes confusas, especialmente al tratar con la conversión de hora local, las bases de datos de zonas horarias del sistema y la aritmética de calendario. En lugar de intentar convencer a los mantenedores actuales de adoptar direcciones radicalmente diferentes, construyó Jiff para encapsular la complejidad del dominio y guiar a los usuarios hacia un uso correcto.
La biblioteca ya ha visto una adopción sustancial en herramientas de producción antes de alcanzar la versión 1.0. Proyectos como uv, Cargo, Starship, fd, Nushell, mise, Jujutsu y uutils/coreutils utilizan actualmente Jiff. También sirve como base para una implementación de Temporal en AWS LLRT. Con este uso generalizado, Gallant declaró la API estable, prometiendo evitar lanzamientos incompatibles con semver a menos que se encuentren defectos críticos. Esta estabilidad está pensada para hacer de Jiff una dependencia pública segura para otras bibliotecas del ecosistema.
Cómo funciona
Jiff modela el manejo de fechas y horas como una cebolla de capas, comenzando desde fechas y horas civiles simples hasta construir datetimes completamente zonificados. En la base están civil::Date y civil::Time, que representan fechas gregorianas planas y horas de reloj no asociadas a ninguna ubicación. Estas se combinan en un civil::DateTime. Por encima de esta capa se encuentra el Timestamp, que representa un instante inequívoco en el tiempo como nanosegundos desde la época Unix. La capa más externa es el ZonedDateTime, que combina un timestamp, un datetime civil y un TimeZone para representar un momento específico en una región geográfica concreta.
La biblioteca toma fuerte inspiración de la biblioteca estándar Temporal de JavaScript, traduciendo sus conceptos de API a idiomatismos de Rust. Por ejemplo, el tipo Duration de Temporal se denomina Span en Jiff para evitar confusiones con std::time::Duration de la biblioteca estándar de Rust. De manera similar, el Instant de Temporal se llama Timestamp para distinguirlo de std::time::Instant. Los tipos civiles en Temporal se denominan "civil" en Jiff. Aunque no es una implementación uno a uno, Jiff permite a los desarrolladores familiarizados con Temporal encontrar la API sencilla. Maneja automáticamente trampas comunes como las transiciones de horario de verano poniendo las reglas de zona horaria en el centro de su diseño.
Detalles clave
- Jiff 1.0 se compromete a una estabilidad indefinida de la API para apoyar su rol como bloque constructor del ecosistema.
- La biblioteca se pronuncia como "gif" con una "g" suave, similar a la palabra "gem" (joya).
- Jiff utiliza el término
Spanpara duraciones yTimestamppara instantes para prevenir conflictos de nombres con tipos de la biblioteca estándar de Rust. - Las zonas horarias se definen utilizando identificadores de la Base de Datos de Zonas Horarias IANA, como
America/New_YorkoAsia/Tokyo. - La biblioteca soporta redondeo de fechas y aritmética de calendario, permitiendo operaciones como redondear un span al día más cercano relativo a una fecha específica.
- Jiff solo soporta el calendario gregoriano y limita su rango de fecha y hora a +/- 9999 años.
Por qué importa
El manejo de fechas y horas es notoriamente propenso a errores porque se sitúa en la intersección entre el tiempo del sistema informático y el tiempo civil humano. El tiempo del sistema depende del tiempo Unix, mientras que el tiempo humano involucra reglas complejas como segundos bisiestos, horario de verano y desplazamientos geográficos. Muchas bibliotecas existentes transmiten esta complejidad al desarrollador, llevando a bugs al convertir entre timestamps y relojes locales. Jiff intenta encapsular esta complejidad, haciendo difícil para los usuarios realizar operaciones inválidas o malinterpretar datos de zona horaria.
Para líderes técnicos e ingenieros que construyen herramientas multiplataforma, tener una biblioteca de fechas y horas estable y bien modelada reduce la carga de mantenimiento. Al adoptar un diseño que previene ambigüedades durante las transiciones de zona horaria, Jiff ayuda a los equipos a evitar bugs sutiles relacionados con cambios de reloj. Su adopción por importantes proyectos de herramientas Rust sugiere que podría convertirse en el estándar de facto para nuevas aplicaciones Rust, reduciendo la fragmentación causada por la elección previa entre chrono y time.
Qué puedes hacer
- Añade
jiffyanyhowa tu proyecto Cargo para probar los ejemplos de API proporcionados en el anuncio. - Revisa el mapeo entre los conceptos de Temporal y los tipos de Jiff si tienes experiencia con el manejo de fechas y horas en JavaScript.
- Reemplaza la lógica heredada de fechas y horas en tus aplicaciones Rust con el
ZonedDateTimede Jiff para asegurar un manejo correcto de zonas horarias. - Usa el tipo
Spanpara aritmética de calendario en lugar de cálculos manuales de segundos para mejorar la legibilidad del código. - Consulta el CHANGELOG para entender los cambios incompatibles entre Jiff 0.2 y 1.0 si eres un adoptante temprano.
- Evalúa Jiff para nuevos proyectos donde la estabilidad a largo plazo de la API es un requisito para dependencias públicas.


