TECH 으로 돌아가기
TECH HACKER NEWS 8분 읽기 48 READS

러스트 날짜·시간 라이브러리 'Jiff' 1.0 출시, 타임존을 전면에 내세우다

러스트(Rust) 생태계에서 날짜와 시간을 다루는 라이브러리 Jiff가 1.0 정식 버전을 공개했다. Jiff는 'gem'의 'g'처럼 부드럽게 발음하는 '지프'로, 이름이 발표된 시점에 이미 uv, Cargo, Starship, fd, Nushell, mise, Jujutsu, uutils/coreutils 등 여러 실전 프로젝트에서 사용되고 있었고 AWS LLRT의 Temporal 구현 기반으로도 쓰이고 있었다. 개발자는 이 정도의 채택 폭이면 1.0을 선언할 때가 됐다고 판단했다고 밝혔다. 특히 중대한 결함이 발견되지 않는 한 1.0을 무기한 유지하겠다는 입장을 내놓았는데, 이는 Jiff가 다른 라이브러리의 공개 API에 등장하는 '생태계 구성 요소'로 쓰이는 것을 염두에 둔 결정이다. 공개 의존성으로 널리 깔린 라이브러리가 semver 호환성을 깨면 생태계 전반에 큰 고통을 주기 때문에, 비호환 릴리스는 함부로 내지 않겠다는 약속이다.

왜 날짜·시간은 늘 어려운가

날짜·시간 라이브러리의 핵심은 컴퓨터의 시간 개념과 사람의 시간 개념이 만나는 지점에 있다. 시스템 시간은 보통 유닉스 시간으로 표현되지만, 사람이 쓰는 시간은 그레고리력에 12시간제나 24시간제 시계를 결합한 훨씬 복잡한 모델이다. 모든 날짜·시간 라이브러리의 바닥에는 이 둘을 변환하는 루틴이 깔려 있다. 개발자는 이 분야가 역사적으로 어려웠던 이유를 '도메인 모델링의 부실함'에서 찾는다. 복잡성을 재사용 가능한 코드 뭉치 안에 가두는 대신, 많은 라이브러리가 그 복잡성의 일부 혹은 전부를 사용자에게 떠넘겼다는 것이다. Jiff는 반대로 복잡성을 최대한 내부에 캡슐화해 사용자가 틀린 코드를 짜기 어렵게 만드는 쪽을 택했다. 라이브러리 자체가 '성공의 구덩이'로 사용자를 유도하도록 설계했다는 표현이 이를 잘 보여준다.

타임존을 API의 중심에 두다

Jiff의 가장 큰 특징은 타임존 처리를 API 전면에 배치했다는 점이다. 개발자는 Jiff의 타입 구조를 양파에 비유한다. 가장 바깥에 ZonedDateTime이 있고, 그 안쪽으로 civil datetime(민간 달력·시계상의 시각), timestamp(특정 순간), time zone 같은 계층이 쌓인다. ZonedDateTime은 두 방향에서 만들 수 있다. 하나는 우리가 달력과 시계에서 보는 민간 시각과 타임존을 결합하는 방식이고, 다른 하나는 데이터베이스나 파일 시스템에서 얻은 timestamp와 타임존을 결합하는 방식이다. 두 경로 모두 동일한 결과에 도달하지만 출발점이 다르다. 여기서 타임존은 'America/New_York' 같은 IANA 타임존 데이터베이스 식별자로 지정하며, 민간 시각을 UTC로 보정하는 오프셋 정보를 품고 있다.

이 구조가 빛을 발하는 지점이 서머타임(일광절약시간) 전환이다. 민간 시각을 오프셋으로 변환하는 과정은 모호성 때문에 까다롭다. 뉴욕에서 시계를 2시 정각에 한 시간 뒤로 돌리면 1시대가 반복되는 'fold'가 발생하고, 반대로 3월에 2시에서 3시로 건너뛰면 존재하지 않는 시각이 생기는 'gap'이 발생한다. Jiff는 기본적으로 'compatible' 전략을 써서 fold의 경우 첫 번째 반복을 선택하지만, TimeZone의 저수준 API를 통해 다른 해소 전략을 고를 수 있다. 서머타임 버그가 소프트웨어의 단골 결함임을 생각하면, 이 모호성을 명시적으로 다루게 한 설계는 실무 관점에서 상당한 의미가 있다.

기간을 표현하는 두 가지 타입

Jiff는 기간을 다루는 타입으로 Span과 SignedDuration을 제공한다. 핵심 원칙은 '가능하면 Span을 쓰라'는 것이다. Span은 각 단위 값을 개별적으로 보존하기 때문에 기간의 원래 의미를 유지할 수 있다. 예컨대 '2시간'과 '120분'은 물리적으로 같은 길이지만 Span에서는 서로 다른 값으로 취급된다. 영화 상영 시간을 한 시간이 넘어도 '분' 단위로 표기하는 관행을 그대로 담을 수 있는 셈이다. 필드 단위 비교가 필요하면 Span::fieldwise를, 실제 물리적 길이로 비교하려면 Span::compare를 쓴다. 다만 Span이 너무 무겁거나 느린 상황에서는 물리적 시간 단위만 다루는 SignedDuration이 대안이 된다.

문자열 변환과 한계

문자열 상호 변환도 Jiff의 주요 기능이다. 내부적으로는 Temporal RFC 9557 / ISO 8601 문법을 구현해 유연하게 파싱하며, 분이나 초가 빠지면 0으로 채우는 등 누락된 구성 요소도 관대하게 처리한다. ZonedDateTime은 항상 IANA 식별자를 포함한 RFC 9557 구문으로 출력된다. 기간 타입은 ISO 8601 duration 포맷을 기본값으로 쓰지만, 여기엔 분명한 약점이 있다. 2000밀리초를 ISO 8601 문자열로 바꿨다가 다시 파싱하면 2초로 되돌아와 원래 구분되던 값이 손실된다. Jiff는 이 문제를 풀기 위해 손실 없이 사람이 읽기 쉬운 자체 'friendly' 포맷을 함께 제공하며, FromStr 구현이 두 포맷을 동시에 받아들인다. 또한 이상적이지는 않지만 널리 쓰이는 POSIX strptime/strftime도 대체로 호환되게 구현해, 익숙한 포맷 문자열로 입출력하려는 개발자를 배려했다.

중요한 것은 Jiff가 항상 정답은 아니라는 점을 개발자 스스로 명시했다는 사실이다. 프로그램 실행 시간을 재는 용도라면 std::time::Instant의 단조(monotonic) 시간을 써야 하고, UTC만으로 충분하고 유닉스 타임스탬프만 다룬다면 표준 라이브러리의 SystemTime으로도 문제가 없다. Jiff의 효용은 SystemTime을 '2026-11-14T21:34:00Z' 같은 RFC 3339 타임스탬프로 바꾸는 식의 복잡한 계산이나, 로컬 시간과 서머타임을 신경 써야 하는 지점에서 비로소 드러난다. 러스트로 국제화된 서비스나 로그·일정 처리를 다루는 실무자라면, 안정적인 공개 의존성을 약속한 1.0 시점이 Jiff 도입을 검토할 만한 적기라 할 수 있다.

SOURCE · HACKER NEWS
원문 전체 보기 → https://burntsushi.net/jiff/
SHARE
NEXT · CHOOSE

변화를 읽었다면,
내가 만들 수익 구조를 고릅니다.

정보를 더 모으는 데서 멈추지 않고, 광고·외주·판매·중개·구독 중 내 상황에 맞는 출발점을 정해보세요.

21가지 수익 구조 살펴보기 →
처리 중...