날짜·시간대 버그 — 한국 시간과 UTC, 월말·연말 주차

이런 일이 생깁니다

• 손님이 밤 11시에 내일 예약을 했는데, 관리자 화면에는 모레로 보입니다.
• "오늘 매출"을 보면 아침 9시 전 주문이 어제 매출로 들어갑니다.
• 1월 31일에 가입한 손님의 "한 달 뒤 결제일"이 3월 3일이 되거나 2월 28일이 됩니다.
• 12월 마지막 주와 1월 첫 주가 같은 "1주차"로 묶여 주간 통계가 이상해집니다.
• 매일 자정에 돌려야 할 작업이 한국 시간 오전 9시에 돕니다.

왜 생기나요 — 한국 시간과 UTC

한국 표준시(KST)는 세계 기준시(UTC)보다 9시간 빠르고, 서머타임이 없습니다. 많은 서버와 데이터베이스, 예약 작업(크론)은 UTC 를 기준으로 돌아갑니다.

그래서 한국 시간 새벽 1시는 UTC 로 전날 오후 4시입니다. 코드가 "오늘 날짜"를 서버 기준으로 잘라 쓰면, 한국 시간 0시부터 9시 사이의 일이 전날로 들어갑니다. 내 컴퓨터(한국 시간)에서 시험할 때는 멀쩡하다가 배포한 서버에서만 틀리는 것도 이 때문입니다.

월말·연말이 까다로운 이유

• 달마다 날 수가 다릅니다(28·29·30·31일). "다음 달 같은 날"이 없는 달이 있어, 1월 31일의 한 달 뒤를 어떻게 정할지 미리 규칙을 정해야 합니다(보통 그달 말일로 맞춤).
• 윤년의 2월 29일에 가입한 손님의 1년 뒤 날짜도 정해 둬야 합니다.
• "몇째 주"는 나라와 도구마다 기준이 다릅니다. 국제 표준(ISO 8601) 주차는 월요일 시작이고 그해 첫 목요일이 든 주를 1주차로 보아, 12월 말 며칠이 다음 해 1주차가 되기도 합니다. 연도와 주차를 함께 쓸 때 "주차의 연도"와 "달력의 연도"가 다를 수 있습니다.

막는 방법

1. 시각은 한 가지 기준(보통 UTC 또는 시간대가 붙은 형식)으로 저장합니다.
2. "오늘", "이번 달", "이번 주"처럼 날짜로 자를 때는 한국 시간(Asia/Seoul)으로 바꾼 다음 자릅니다.
3. 예약 작업의 실행 시각을 적을 때 UTC 인지 한국 시간인지 확인합니다. 한국 시간 자정은 UTC 로 전날 15시입니다.
4. "한 달 뒤", "말일", "주차"의 규칙을 문장으로 정해 두고 코드에도 그대로 적게 합니다.
5. 아래 날짜로 직접 시험합니다: 한국 시간 새벽 0시 30분과 8시 59분, 1월 31일, 2월 28·29일, 12월 29~31일, 1월 1일.

내 AI 에게 점검 맡기기

자주 묻는 질문

함께 보면 좋은 글

• 예약 발송·정기 결제가 한 건 실패로 전부 멈출 때 막는 법
• AI 에게 수정 맡길 때 다른 기능이 안 망가지게 하는 법
• 바이브코딩 앱 출시 전 체크리스트 — 8개 분야 한 번에 점검

참고

• ISO 8601 주차(ISO week date) 설명