가이드
타임스탬프 시간대 혼동 디버깅 방법
API·DB·프론트엔드 사이에서 발생하는 시간대 불일치를 단계별로 찾는 방법입니다.
시간대 문제는 저장과 표시 기준이 다를 때 발생합니다. 변환 지점을 순서대로 추적하면 빠르게 원인을 찾을 수 있습니다.
Find the source of truth
Identify where the original time is created and in what timezone.
Without this anchor, downstream debugging becomes guesswork.
Track conversions across layers
Check backend serialization, API transport, and frontend rendering separately.
A single implicit conversion can shift output by hours.
Use fixed test values
Test with known timestamps and compare expected vs actual at each step.
- Use UTC examples.
- Include DST boundary dates.
- Test from multiple client timezones.
Log timezone metadata
When possible, log timezone context alongside timestamp values.
This makes future incident debugging much faster.
Common scenarios
- API returns UTC but UI shows local time.
- Database values look shifted.
- Scheduled events fire at wrong hour.
- Reports differ by region.
Trace each conversion step
Write down source timezone, transport format, and display timezone for each layer to remove guesswork.