"9시"는 생각보다 여러 뜻이에요. 서울 9시에 잡은 뉴욕 동료와의 통화는 지구 어디서 보든 같은 한 순간이에요. 뉴욕에서 보면 전날 저녁 8시예요(서머타임이면). 그런데 "아침 8시 약 먹기"는 출장을 가도 그곳의 8시여야 해요. 생일은 시각이 아니라 하루 전체고요. "보고서 쓰기"에는 아예 시간이 없을 수도 있어요.
이걸 한 칸에 담으려 하면 어딘가에서 틀려요. 그래서 ikie는 시간을 네 종류로 나눠 따로 저장해요.
네 종류, 네 묶음의 칸
| 종류 | 뜻 | 저장하는 칸 |
|---|---|---|
| date | 하루 종일. 끝 날 자체는 포함하지 않아요 | 시작 날, 끝 날 |
| zoned | 한 순간. 어디서 보든 같아요 | 시작·끝 순간(UTC), 시작·끝 시간대(IANA) |
| floating | 벽시계 시각. 어디에 있든 그 시각이에요 | 시작·끝 현지 시각(시간대 없음) |
| 없음 | 시간이 없어요 | 없음 |
종일의 끝 날을 포함하지 않는 것(10일 하루면 시작 10일, 끝 11일)은 iCalendar의 DTEND, Google의 end.date와 같아요. 외부와 맞출 때 하루씩 어긋나지 않게요. floating은 iCalendar와 Apple 캘린더에는 있지만 Google 캘린더에는 없어요. Google로 보낼 때는 내 기본 시간대로 바꿔요.
종류마다 써야 하는 칸은 데이터베이스가 지켜요.
time_kind text check (time_kind in ('date', 'zoned', 'floating')), -- NULL = 시간 없음
constraint item_time_date check (time_kind <> 'date' or (start_date is not null and end_date is not null and end_date > start_date)),
constraint item_time_zoned check (time_kind <> 'zoned' or (start_at is not null and end_at is not null and start_tz is not null and end_tz is not null and end_at >= start_at)),
constraint item_time_floating check (time_kind <> 'floating' or (start_local is not null and end_local is not null and end_local >= start_local)),
constraint item_rrule_needs_time check (rrule is null or time_kind is not null)
어느 날의 일정을 읽을 때 쓰는 범위 색인도 종류마다 따로 둬요(시각 범위, 날짜 범위, 시간대 없는 시각 범위). 반복은 시간이 있어야만 둘 수 있어요.
일정과 할 일은 끝나는 방식이 달라요
일정과 할 일은 같은 항목이지만, 가르는 것은 끝나는 방식이에요. 일정은 시간이 지나면 끝나고, 할 일은 내가 끝내야 끝나요. 그래서 같은 시간 칸도 일정에서는 약속이고, 할 일에서는 계획이에요.
- 날만 정한 할 일은 시간 칸이 아니라 "할 날" 한 칸에 둬요. 끝내지 않은 채 그날이 지나면 오늘로 넘어와요.
- 시각을 잡은 할 일을 끝내지 않고 그 시간이 지나면, 사라지지 않고 할 일 모음(날짜 없는 할 일 목록) 맨 위 "놓친 할 일"로 돌아와요. 하는 중인 할 일은 시간을 넘겨도 놓친 게 아니에요. 아직 하고 있으니까요.
- 마감은 할 시간과 다른 칸이에요. "금요일까지"는 마감 날만 두고 그날 끝까지로 봐요. "내일 오후 3시까지"처럼 시각까지 말하면 그 순간을 함께 둬요.
누구의 시간대로 보나
시간을 저장하는 것만큼 어려운 건 보는 일이에요. 종일 일정의 "10일"과 floating 시각의 "8시"는 보는 사람의 시간대로 읽어야 하고, "오늘"이 언제 끝나는지도 그 시간대가 정해요.
ikie에서 보는 시간대를 정하는 곳은 한 함수예요.
export function viewerTz(fixedTz, deviceTz, accountTz): string {
return pickTz(fixedTz, deviceTz, accountTz); // 맞는 첫 값, 없으면 UTC
}
- 설정에서 고정한 시간대
- 기기의 시간대(앱은 요청 머리글로, 웹은 쿠키로 알려요)
- 계정의 시간대
- 그래도 없으면 UTC
계정의 시간대는 기기를 따라가요. 기기가 알려 준 시간대가 바뀌면 계정에 다시 적어요. 요청 없이 도는 일(알림, 외부 캘린더 맞추기, 할 일 원본 맞추기)도 같은 순서를 쓰고, 기기 시간대 자리에는 가장 최근에 등록된 알림 기기의 것을 써요. 서버의 유스케이스 코드가 시간대를 모를 때 "UTC"로 짐작해 넘어가는 것은 시험이 막아요.
서머타임
서머타임이 있는 곳에서 하루는 늘 24시간이 아니에요. 봄에는 23시간, 가을에는 25시간이에요. 그래서 날을 더할 때 24시간을 더하지 않고 벽시계의 날짜를 셈해요. iOS 시간표도 그날은 23시간이나 25시간으로 그리고, 시 글자도 실제 벽시계를 따라요(2시가 없거나 1시가 두 번).
없는 시각과 두 번 있는 시각도 정해야 해요. 뉴욕이라면 봄에 건너뛰는 새벽 2시 30분은 앞으로 밀고, 가을에 두 번 오는 1시 30분은 앞의 것을 골라요. RFC 5545와 Google·Apple이 하는 방식이에요.
반복은 시리즈를 시작한 곳의 현지 시각으로 펼쳐요. 매주 월요일 9시 회의는 서머타임이 시작돼도 9시예요. UTC로 펼치면 서머타임을 지나며 8시나 10시로 밀려요.
시간이 우리를 넘어뜨린 곳
- 9시간 밀린 블록. iOS가
…T05:00:00Z같은 순간을 읽으며 끝의Z를 떼고 벽시계 값으로 읽었어요. 서울에서는 꾹 눌러 든 블록이 9시간 앞으로 밀려 화면 밖에 그려졌어요. 데모 데이터에는 시간대가 없어서 시뮬레이터에서는 드러나지 않았어요. - 동쪽에서는 하루 일찍. 할 일 모음의 "일정에 넣기" 목록이 종일 일정의 날짜를 UTC 날짜로 적어서, UTC보다 동쪽(한국 포함)에서는 하루 일찍 보였어요. iOS에서는 편집 시트가 시간을 그날 안으로 잘라서 열려, 제목만 고쳐도 자정을 넘는 일정이 잘리기도 했어요.
- 시간대 없는 입력. 일정을 옮기거나 할 일에 시간을 잡는 API 입력에
Z나+09:00이 없으면 서버가 UTC로 읽어 사용자 시차만큼 밀었어요. 지금은 시간대 없는 순간을invalid_time으로 거절해요. 짐작하지 않고 분명히 실패하는 쪽을 골랐어요. - 1970년의 뉴욕. 시트에서 시간대 이름 옆에 붙는 시차(GMT+9 같은)를 1970년 1월 1일 기준으로 계산해, 서머타임 중인 뉴욕이 GMT-5로 보였어요. 지금의 시차로 계산하게 고쳤어요.
- 24시간 더하기. 종일 일정의 끝을 24시간 더해 구하던 곳에서, 서머타임이 끝나는 날 끝이 시작보다 앞섰어요.
- 가입한 날의 시간대. 계정 시간대가 가입할 때의 값에 머물러, 연결한 Claude(MCP)가 낡은 시간대로 "오늘"을 읽었어요. 알림은 가장 먼저 등록한 기기가 등록할 때의 시간대를 그대로 썼고요. 그래서 계정 시간대가 기기를 따라가게 하고, 알림은 가장 최근 기기를 보게 했어요.
- UTC로 들어온 Slack 할 일. Slack 메시지로 만든 할 일이 시간대를 모른 채 "UTC"로 들어갔어요. 요청 없이 도는 일도 같은 순서로 시간대를 정하게 하고, 유스케이스 코드의
UTC짐작을 막는 시험을 더했어요.
floating은 조심스럽게
floating 시각은 "어디서든 8시"라 혼자 보는 일정에는 맞지만, 다른 사람과 맞추기는 어려워요. 같은 "8시"가 보는 사람마다 다른 순간이니까요. 그래서 시간표에서 floating 블록은 끌어 옮기지 못하게 잠그고 시트에서 고치게 해요. 반복 회차를 끌어 옮길 때도 종일 ↔ 시각처럼 시간 종류가 바뀌거나 floating이 끼면 시트로 보내요. 다른 사람의 남는 시간을 볼 때 그 사람의 floating 시각은 그 사람의 시간대로 읽어요.
배운 것
시간 버그는 대부분 "시간이 무엇인가"를 한 가지로 가정한 곳에서 났어요. 순간과 벽시계와 하루를 같은 칸에 담거나, 하루를 늘 24시간으로 보거나, 시간대를 모르면 UTC로 짐작한 곳들이요. 종류를 나눠 저장하고, 데이터베이스가 종류마다 칸을 지키고, 보는 시간대를 한 함수가 정하게 하자 같은 종류의 버그가 덜 생겼어요. 그리고 짐작 대신 분명한 실패를 골랐어요. 시간대 없는 시각은 받지 않아요.