·2분 읽기
Unix 타임스탬프 변환 완벽 가이드 — 초 단위 시간을 날짜로
Unix 타임스탬프를 날짜로 변환하는 방법과 원리를 정리했습니다. 밀리초 vs 초 차이, 타임존 처리, 실무 활용법까지 담았어요.
🕐
타임스탬프 변환기 바로 사용하기
Unix 타임스탬프와 날짜를 변환하세요
→
Unix 타임스탬프란?
Unix 타임스탬프는 1970년 1월 1일 00:00:00 UTC부터 현재까지 흐른 초(또는 밀리초)를 숫자로 나타낸 거예요. 예를 들어 1713340800은 2024년 4월 17일을 의미해요.
왜 이렇게 복잡한 숫자를 쓰냐면, 날짜 형식은 나라마다 다르거든요. 미국은 MM/DD/YYYY, 한국은 YYYY-MM-DD, 유럽은 DD/MM/YYYY. 이런 혼란을 피하려고 전 세계 개발자가 동일한 숫자 기준을 쓰는 거예요.
초(seconds) vs 밀리초(milliseconds) 구분법
타임스탬프를 다룰 때 가장 많이 실수하는 부분이에요.
- 10자리 숫자 (예: 1713340800) → 초 단위 (Unix timestamp)
- 13자리 숫자 (예: 1713340800000) → 밀리초 단위
JavaScript의 Date.now()는 밀리초를, Python의 time.time()은 초를 반환해요. 서로 다른 언어 간에 타임스탬프를 주고받을 때 이 차이를 놓치면 1970년대 날짜가 나오거나 미래 날짜가 나오는 버그가 생겨요.
Toolkio 타임스탬프 변환기에 숫자를 넣으면 초인지 밀리초인지 자동으로 감지해서 변환해줘요.
타임존 처리 주의사항
타임스탬프 자체는 UTC 기준이에요. 한국 시간(KST)은 UTC+9이기 때문에 변환할 때 9시간을 더해야 해요.
**흔한 실수**: 서버는 UTC로 저장하는데 프론트에서 타임존 변환 없이 그대로 보여주면 9시간 차이가 나요. 한국에서 오후 3시에 작성한 글이 오전 6시로 보이는 거예요.
**올바른 처리 방법**:
1. 서버에는 항상 UTC 타임스탬프로 저장
2. 프론트에서 사용자의 로컬 타임존으로 변환해서 표시
3. JavaScript: new Date(timestamp * 1000).toLocaleString('ko-KR')
실무에서 타임스탬프 쓰는 상황
**1. 로그 분석**
서버 로그에 찍히는 시간이 타임스탬프인 경우가 많아요. 에러 시점을 정확히 파악하려면 변환이 필요해요.
**2. API 응답 파싱**
created_at, updated_at 같은 필드가 타임스탬프로 오는 API가 많아요.
**3. 캐시 만료 시간**
Redis나 CDN에서 TTL(Time To Live)을 타임스탬프로 설정해요.
**4. JWT 토큰**
JWT의 exp(만료), iat(발급 시간) 필드가 Unix 타임스탬프예요.
Toolkio 타임스탬프 변환기로 빠르게 확인하면 디버깅 시간을 크게 줄일 수 있어요.