TECH 으로 돌아가기
TECH HACKER NEWS 9분 읽기 44 READS

Rust 날짜·시간 라이브러리 Jiff 1.0 — 서머타임 버그를 타입으로 막는 방법

무슨 일이 있었나

Rust의 날짜·시간 라이브러리 Jiff가 1.0에 도달했어요. 만든 사람은 ripgrep과 regex 크레이트로 유명한 Andrew Gallant(BurntSushi)예요. Jiff는 2024년 여름에 처음 공개된 뒤 0.x 버전으로 다듬어져 왔는데요, Rust 생태계에서 1.0은 꽤 무게가 있는 숫자예요. '이제 API를 함부로 깨지 않겠다'는 약속이거든요. 날짜·시간 타입은 DB 모델, API 응답, 설정 파일 등 코드 곳곳에 퍼지기 때문에, 이 약속이 있어야 회사 프로젝트에 마음 놓고 넣을 수 있어요.

날짜 계산이 왜 그렇게 어렵냐면

'내일 같은 시각'을 구하려고 24시간을 더하는 코드, 한 번쯤 써보셨을 거예요. 한국에서는 잘 돌아가요. 그런데 서머타임(여름에 시계를 한 시간 앞당기는 제도)이 있는 지역에서는 1년에 두 번 틀려요. 하루가 23시간이거나 25시간인 날이 있거든요. '1월 31일에 한 달을 더하면 며칠인가' 같은 질문도 있죠. 시간 버그는 대부분 절대적인 한 순간과 달력·시계에 적힌 값을 섞어 쓰다가 생겨요.

Jiff는 이 둘을 타입으로 갈라놓았어요.

코드로 보면

서머타임이 시작되는 날을 끼고 계산해 볼게요. 2024년 3월 10일 새벽, 뉴욕은 시계를 한 시간 앞으로 돌렸어요.

use jiff::{ToSpan, Zoned};

let zdt: Zoned = "2024-03-09T17:00[America/New_York]".parse()?;
let next_day = zdt.checked_add(1.day())?;
let after_24h = zdt.checked_add(24.hours())?;
// next_day -> 2024-03-10T17:00:00-04:00[America/New_York]
// after_24h -> 2024-03-10T18:00:00-04:00[America/New_York]

1.day()를 더하면 벽시계 기준으로 다음 날 오후 5시가 되고, 24.hours()를 더하면 실제로 24시간이 흐른 오후 6시가 돼요. 둘이 다르다는 걸 라이브러리가 알고 있고, 개발자는 의도에 맞는 쪽을 고르기만 하면 돼요. 시계를 건너뛰어서 존재하지 않는 시각이나 두 번 나타나는 시각을 어떻게 해석할지도 정해진 규칙에 따라 처리해 줘요. 위 코드는 공개 문서의 기본 API 기준이니, 세부 이름은 1.0 문서에서 한 번 더 확인하세요.

출력 형식도 눈여겨볼 만해요. 오프셋 뒤에 시간대 이름이 대괄호로 붙어 있는데요, 이건 RFC 9557이라는 표준 형식이에요. 오프셋(-04:00)만 저장하면 '이 값이 뉴욕 시간이었다'는 정보가 사라져서 나중에 달력 계산을 다시 할 수 없거든요. Jiff는 시간대 이름까지 문자열에 담아서, 직렬화했다가 다시 읽어도 정보가 그대로 남게 했어요.

시간대 데이터베이스(IANA tzdb, 전 세계 시간대 규칙을 모아둔 자료)도 기본으로 다뤄요. 유닉스 계열에서는 시스템에 있는 데이터를 읽고, 그런 데이터가 없는 윈도우 같은 환경에서는 크레이트에 묶어둔 사본을 써요. 별도 크레이트를 찾아 붙일 필요가 없는 거죠.

기존 라이브러리와 뭐가 다른가

Rust에는 이미 chrono와 time이 있어요. chrono는 가장 널리 쓰이지만 시간대 데이터베이스를 쓰려면 chrono-tz를 따로 붙여야 하고, 서머타임을 고려한 달력 연산은 개발자가 직접 챙겨야 하는 부분이 많아요. time은 가볍고 탄탄하지만 IANA 시간대를 본격적으로 지원하지는 않아요. Jiff는 시간대를 제대로 다루는 것을 기본값으로 두고, 틀리기 쉬운 연산을 타입과 API 설계로 막는 쪽을 택했어요.

이 설계의 뿌리는 자바스크립트의 Temporal이에요. Temporal은 문제 많던 Date를 대체하려고 TC39(자바스크립트 표준을 정하는 위원회)에서 오랫동안 다듬어 온 API인데, Jiff는 그 개념 모델을 Rust답게 옮겨 왔어요. 자바의 java.time과 그 전신인 Joda-Time도 같은 계보죠. 언어마다 '순간, 벽시계 시각, 시간대 붙은 시각을 구분하자'는 결론에 도달하고 있다는 점이 흥미로워요.

한계도 알아두세요. Jiff는 윤초(지구 자전에 맞추려고 가끔 끼워 넣는 1초)를 따로 모델링하지 않고, 달력 연산은 그레고리력 기준이에요. 다른 역법이나 지역화된 날짜 표기가 필요하면 jiff-icu로 ICU4X와 연결하는 방식을 써요.

한국 개발자에게 주는 시사점

한국은 서머타임이 없어서 이런 버그를 체감하기 어려워요. 그래서 오히려 위험해요. 국내에서만 테스트한 예약·구독·정산 로직이 해외 사용자를 받는 순간 깨지는 경우가 많거든요. 글로벌 서비스를 준비 중이거나 여러 나라 시간대로 예약과 알림을 처리한다면 Jiff의 모델이 큰 도움이 돼요.

새 Rust 프로젝트라면 Jiff부터 검토해 볼 만해요. serde는 기능 플래그로 지원하고, jiff-sqlx, jiff-diesel 같은 연동 크레이트도 있어요. 반대로 chrono 타입이 이미 DB 레이어와 API 전반에 깔린 프로젝트라면, 한 번에 갈아엎기보다 새 모듈부터 경계를 정해 도입하는 게 현실적이에요. Rust를 안 쓰더라도 문서는 읽어볼 가치가 있어요. 시간 처리의 함정을 정리한 설명이 워낙 꼼꼼해서 어떤 언어를 쓰든 설계 감각을 키워주거든요.

마무리

한 줄 정리: Jiff 1.0은 시간 계산이 원래 어렵다는 걸 인정하고, 그 어려움을 타입으로 드러내면서도 쓰기 쉽게 만든 라이브러리예요. 여러분 프로젝트에서는 날짜를 어떤 형태로 저장하고 있나요? UTC 타임스탬프만 저장했다가 사용자가 원래 의도한 시간대를 잃어버려 곤란했던 경험이 있다면 들려주세요.


🔗 출처: Hacker News

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

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

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

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