Вышла Jiff 1.0: библиотека дат и времени для Rust со стабильным API
Вышла версия 1.0 Jiff, библиотеки дат и времени для Rust. Автор объявил о релизе в блоге и заодно провёл экскурсию по API. Главная идея библиотеки: сделать работу с часовыми поясами центральной частью интерфейса, чтобы многие типовые проблемы перехода на летнее и зимнее время решались автоматически. Произносится название как «gif» с мягким «g», как в слове «gem».
Главное в релизе, обязательство по стабильности. Автор пишет, что Jiff уже работает в продакшене во многих проектах: uv, Cargo, Starship, fd, Nushell, mise, Jujutsu, uutils/coreutils, а также служит основой для реализации Temporal в AWS LLRT. Поэтому, по его словам, пора ставить 1.0. Если в API Jiff не найдут серьёзного дефекта, он планирует придерживаться версии 1.0 бессрочно. Причина, Jiff задуман как строительный блок экосистемы, который появляется в публичном API других библиотек. Для такой публичной зависимости несовместимые по semver релизы (семантическому версионированию) вызовут много проблем в экосистеме, поэтому их не будут выпускать легкомысленно. Список ломающих изменений между 0.2 и 1.0 автор не приводит, а отсылает к файлу CHANGELOG.
Во введении автор объясняет философию. Ядро любой библиотеки дат и времени, преобразование между системным временем (чаще всего Unix-временем) и человеческим представлением (григорианский календарь плюс 12- или 24-часовые часы). По его убеждению, сложность работы с датами во многом идёт от плохого моделирования предметной области: многие библиотеки перекладывают сложность на пользователей, а Jiff старается заключить её внутрь и затруднить ошибки (при этом он не первый, кто так делает).
Далее вводится словарь: гражданское время (civil time), то, что показывают часы рядом с вами; UTC, стандарт, основа гражданского времени; TAI, атомное время; високосная секунда; Unix-время, это UTC без учёта високосных секунд. Типы Jiff автор сравнивает с луковицей: civil::Date, календарная дата без привязки к месту; civil::Time, время на часах с точностью до наносекунды; civil::DateTime, их сочетание; Timestamp, однозначный момент времени, хранится как число наносекунд от начала эпохи Unix; TimeZone, набор правил соответствия между Timestamp и civil::DateTime в конкретном регионе; ZonedDateTime объединяет всё это и описывает момент времени в конкретном месте.
Примеры на коде показывают два пути к ZonedDateTime: от гражданской даты и времени плюс часовой пояс (17:30 1 ноября 2026 года в America/New_York даёт метку 1793572200 секунд) либо от метки времени плюс пояс. Затем вводится смещение (offset) от UTC: 22:30 по UTC минус 5 часов даёт 17:30 в Нью-Йорке. Часовой пояс определён как регион с двумя отображениями: от момента времени к смещению и от гражданского времени к возможно неоднозначному смещению.
Неоднозначность возникает на переходах. Когда часы переводят назад, как в Нью-Йорке 1 ноября 2026 года в 2 часа ночи, час с 1:00 повторяется, и время 1:30 встречается дважды. По умолчанию Jiff выбирает первое вхождение (смещение -04:00, летнее время), хотя 2:30 уже относится к стандартному времени (-05:00). Стратегией по умолчанию служит «compatible»; через API TimeZone можно выбрать другую: earlier (раннее), later (позднее, то есть второе повторение часа, смещение -05:00) или unambiguous, которая возвращает ошибку при любой неоднозначности («datetime is ambiguous since it falls into a fold between offsets -04 and -05»). Затем автор переходит к пропускам (gap): 8 марта 2026 года в 2 часа ночи гражданское время в Нью-Йорке перескакивает на 3 часа. Доступный фрагмент текста обрывается на этом примере; разделы про разбор и форматирование, операции с датами и интервалами и заключение в нём не видны.
Ключевые факты
- Вышла Jiff 1.0, библиотека дат и времени для Rust; автор объявил релиз в блоге и показал API на примерах.
- Автор планирует придерживаться 1.0 бессрочно, если не найдёт серьёзного дефекта; несовместимые релизы «не будут делаться легкомысленно».
- По словам автора, Jiff уже в продакшене в uv, Cargo, Starship, fd, Nushell, mise, Jujutsu, uutils/coreutils и в реализации Temporal в AWS LLRT.
- Часовые пояса поставлены в центр API; при неоднозначном времени при переводе часов назад (1:30 в Нью-Йорке) по умолчанию выбирается первое вхождение, стратегия «compatible».
- Типы устроены как «луковица»: Date, Time, DateTime, Timestamp (наносекунды от эпохи Unix), TimeZone и ZonedDateTime.
Почему это важно
Для библиотек, которые попадают в публичный API других пакетов, стабильность важнее всего: несовместимый релиз ломает цепочку зависимостей. Автор прямо называет это причиной обязательства по версии 1.0: он хочет, чтобы Jiff стал «строительным блоком экосистемы». Для Rust-разработчиков это сигнал, что библиотеку можно закладывать в публичные интерфейсы. Технически подход интересен тем, что сложность часовых поясов и перехода на летнее время инкапсулируется в типах, а не перекладывается на пользователя.
Кому это важно
Прежде всего Rust-программистам, которым нужна удобная работа с датой и временем; именно их автор называет целевой аудиторией. Также мейнтейнерам библиотек и инструментов, которым нужна зависимость с предсказуемым API: Jiff уже используют, по словам автора, uv, Cargo, Starship, fd, Nushell, mise, Jujutsu и uutils/coreutils.
Как это применить
Чтобы попробовать, автор предлагает создать проект командами cargo init --bin и cargo add jiff anyhow, затем вставить примеры в src/main.rs и запустить cargo run. Большинство примеров, самодостаточные программы. При миграции с версии 0.2 нужно смотреть CHANGELOG со списком ломающих изменений. Для задач с летним временем стоит знать стратегии разрешения неоднозначности: compatible (по умолчанию), earlier, later и unambiguous, которая возвращает ошибку. Про цену и лицензию в доступном тексте ничего не сказано.
Можно ли доверять
Источник, собственный анонс автора библиотеки, то есть первоисточник, но заинтересованный: утверждения о широком распространении и об удобстве API исходят от него самого. Независимых цифр (число загрузок, замеры, сравнение с другими крейтами для дат и времени) в тексте нет, а список ломающих изменений вынесен в отдельный файл CHANGELOG. Доступный фрагмент оборван, так что разделы про разбор и форматирование, операции с датами и интервалами и заключение не прочитаны.
Риски и подводные камни
Обязательство по 1.0, это именно план автора («my plan»), а не формальная гарантия: оно действует, пока не найден серьёзный дефект в API, срок слова «бессрочно» не уточняется, как и механизмы, закрепляющие обязательство. Переход с 0.2 на 1.0 содержит ломающие изменения. Сами правила часовых поясов коварны: гражданское время в «пропуске» может не существовать, а в «складке» встречается дважды, поэтому стоит осознанно выбирать стратегию, а не полагаться на умолчание.
«Если в API Jiff не найдут серьёзного дефекта, мой план, придерживаться Jiff 1.0 бессрочно.»
— автор Jiff, анонс релиза 1.0