Вышла Jiff 1.0: библиотека даты и времени для программистов на Rust
Разработчик BurntSushi выпустил Jiff 1.0 — библиотеку даты и времени для языка Rust, в которой обработка часовых поясов вынесена на первый план. Её уже используют несколько известных проектов, а автор намерен сохранять API версии 1.0 неопределённо долго.
Библиотека даты и времени Jiff для языка программирования Rust достигла версии 1.0. Об этом в своём блоге сообщил автор библиотеки, разработчик под псевдонимом BurntSushi, сопроводив анонс обзором API. Библиотека рассчитана на Rust-программистов, которым нужна удобная работа с датой и временем. В основе её дизайна лежат часовые пояса, поэтому многие типичные проблемы, связанные с переходом на летнее и зимнее время, решаются автоматически.
Использование и обещание совместимости
По словам автора, Jiff уже применяется в продакшене во многих проектах, среди которых uv, Cargo, Starship, fd, Nushell, mise, Jujutsu и uutils/coreutils. Кроме того, она лежит в основе реализации Temporal в AWS LLRT. Поэтому, как считает автор, пора выпускать версию 1.0.
Если в API не обнаружат серьёзного дефекта, он планирует придерживаться версии 1.0 неопределённо долго. Цель — сделать Jiff базовым элементом экосистемы, который появляется в публичном API других библиотек. Выпуски, несовместимые по семантическому версионированию, причинили бы заметные неудобства, поэтому их не будут делать легкомысленно. Изменения между версиями 0.2 и 1.0 перечислены в CHANGELOG.
Как библиотека моделирует время
Автор считает, что работа с датой и временем исторически давалась трудно из-за плохого моделирования предметной области: многие библиотеки перекладывают сложность на пользователей. Jiff, напротив, старается скрыть эту сложность и затруднить ошибки.
Типы библиотеки автор сравнивает с луковицей. Внутренние слои — civil::Date (дата по григорианскому календарю), civil::Time (время на часах с точностью до наносекунды) и civil::DateTime, объединяющий их без привязки к месту. Timestamp обозначает конкретный момент как число наносекунд с начала эпохи Unix, а TimeZone — набор правил, переводящий момент в гражданские дату и время и обратно. Внешний слой, ZonedDateTime, объединяет всё перечисленное.
Неоднозначность при переводе часов
В статье показано и то, как Jiff справляется с переводом часов. Когда часы переводят назад и один час повторяется, по умолчанию выбирается первое повторение. Это поведение можно изменить: выбрать более позднее время или потребовать ошибку при любой неоднозначности.

