읽는 데 5분
Jiff 1.0으로 매월 31일 일정을 계산해 봤어요
매월 31일에 알림을 보내기로 했어요. 2월에는 마지막 날로 당겨도, 3월에는 다시 31일로 돌아오길 기대하겠죠. 그런데 Jiff 1.0으로 직전 날짜에 한 달씩 더하자 1월 31일 → 2월 28일 → 3월 28일이 나왔어요. 처음 날짜에 두 달을 한 번에 더하면 3월 31일이었고요.
이 차이는 날짜 계산이 틀려서 생긴 게 아니에요. 다음 실행 날짜만 저장하면 원래 원했던 날짜를 잃을 수 있어요. 평년과 윤년, 30일 시작과 31일 시작을 같은 작은 프로그램에 넣어 비교했어요.
Jiff는 Andrew Gallant가 만든 Rust 날짜·시간 라이브러리예요. 2026년 11월 15일 1.0을 발표했고, 글쓴이는 중대한 API 결함이 없다면 1.0을 오래 유지할 계획이라고 밝혔어요. 이번에는 시간대 기능 전체를 소개하기보다 반복 알림의 날짜 계산 한 가지를 볼게요.
2월은 두 가지 시작 날짜를 같게 만들어요
날짜에 ‘한 달’을 더할 때는 도착할 달에 그 날짜가 있는지 봐야 해요. 원문은 1월 31일에 한 달을 더하면 2월 28일로 조정되는 예제를 보여 줘요. 저는 여기서 계산한 결과를 문자열로 바꿨다가 다시 읽어, 그 결과만 가지고 다음 회차를 만들었어요.
비교한 방식은 둘이에요.
- 직전 결과 방식: 마지막 날짜를 읽고
1.month()를 더해요. 새 결과가 다음 계산의 출발점이에요. - 최초 기준일 방식: 처음 날짜를 읽고 회차
n만큼n.months()를 더해요. 처음 날짜는 그대로 남겨 둬요.
Linux, Rust 1.100.0, Jiff 1.0.0에서 나온 결과예요. 아래 셀은 첫 번째·두 번째·세 번째 회차를 순서대로 적었어요.
| 시작 날짜 | 직전 결과에 한 달씩 | 최초 기준일에 회차만큼 |
|---|---|---|
| 2027-01-31 | 02-28 → 03-28 → 04-28 | 02-28 → 03-31 → 04-30 |
| 2027-01-30 | 02-28 → 03-28 → 04-28 | 02-28 → 03-30 → 04-30 |
| 2028-01-31 | 02-29 → 03-29 → 04-29 | 02-29 → 03-31 → 04-30 |
| 2027-01-15 | 02-15 → 03-15 → 04-15 | 02-15 → 03-15 → 04-15 |
눈여겨볼 것은 첫 두 줄이에요. 30일에 시작해도 31일에 시작해도 직전 결과 방식에서는 2월 28일이 돼요. 그 값만 남기면 3월에 30일로 돌아가야 했는지, 31일로 돌아가야 했는지 구별할 수 없어요. 윤년에는 같은 일이 29일에서 생겼고, 15일 시작은 두 방식이 같았어요.
기억해야 하는 것은 날짜 하나보다 많아요
핵심 비교는 이 코드로 줄일 수 있어요. 의존성은 jiff = "=1.0.0"으로 고정했어요.
use jiff::{civil::Date, ToSpan};
fn main() -> Result<(), Box<dyn std::error::Error>> {
let anchor: Date = "2027-01-31".parse()?;
let feb = anchor.checked_add(1.month())?;
let stored_last = feb.to_string();
let restored_last: Date = stored_last.parse()?;
println!("chained: {}", restored_last.checked_add(1.month())?);
println!("anchored: {}", anchor.checked_add(2.months())?);
Ok(())
}
checked_add는 날짜 범위를 벗어나면 오류를 돌려주는 덧셈이에요. 이 예제의 두 결과는 각각 2027-03-28, 2027-03-31이에요. 문자열로 바꾸고 다시 읽는 것만으로는 없어진 기준일이 돌아오지 않아요.
‘매월 31일, 없는 달에는 마지막 날’이 제품의 규칙이라면 최초 기준일과 회차를 남기고 매번 그 기준에서 계산할 수 있어요. 반대로 조정된 날짜를 이후에도 계속 쓰는 제품이라면 직전 결과 방식이 맞을 수 있죠. 라이브러리가 계산해 주는 한 번의 덧셈과, 서비스가 정해야 할 반복 규칙은 따로예요.
또 ‘매월 30일’과 ‘매월 마지막 날’도 구별해야 해요. 표에서 1월 30일을 기준으로 두 달 뒤를 구하면 3월 30일이에요. 월말 전용 일정이라면 마지막 날이라는 규칙 자체를 남겨야 해요. Jiff로 바꾼다는 이유만으로 저장된 날짜 하나가 그 의도를 대신해 주지는 않아요.
확인한 범위
- 기준일: 2026-11-17
- 직접 한 것: Linux, Rust 1.100.0에서 Jiff 1.0.0에 네 가지 시작 날짜를 넣었어요. 날짜를 문자열로 바꾸고 다시 읽으며 직전 결과 누적과 최초 기준일 계산의 세 회차를 비교했어요. 평년·윤년의 3월 결과와 15일 시작의 일치를 코드의 단언문으로도 확인했어요.
- 읽은 것: Jiff 1.0 발표의 날짜 계산 설명과 공식 API 문서, GeekNews의 한국어 소개를 읽었어요.
- 확인하지 못한 것: 실제 데이터베이스 저장·프로세스 재시작·알림 작업은 시험하지 않았어요. 시간대와 시각, 서머타임 전환이 포함된 반복 일정은 이번 비교 범위 밖이에요.



