·2분 읽기
타임스탬프 변환기 활용 — Unix 시간과 UTC 시간대 변환 5가지 시나리오
Unix 타임스탬프를 한국 시간으로 변환하고, UTC와 KST를 헷갈리지 않게 다루는 5가지 실전 시나리오를 정리했어요.
🕐
타임스탬프 변환기 바로 사용하기
Unix 타임스탬프와 날짜를 변환하세요
→
Unix 타임스탬프란?
Unix 타임스탬프는 1970년 1월 1일 00:00:00 UTC부터 지난 초 단위 숫자예요. 예) 1735689600은 2025년 1월 1일 00:00 UTC.
왜 이런 방식을 쓸까요? 시간대·서머타임·윤년 같은 변수를 모두 한 숫자로 압축해서 컴퓨터끼리 시간 정보를 정확히 주고받을 수 있어서예요. 데이터베이스·로그·API 응답에서 거의 모든 시스템이 Unix 타임스탬프를 기본으로 사용해요.
시나리오 1) 로그 파일 분석
서버 로그에 `[1735689600]` 같은 숫자가 찍히는데 이게 언제인지 모를 때 변환기가 필수예요.
- 13자리: 밀리초 단위 (Java·JavaScript Date.now())
- 10자리: 초 단위 (Linux·PHP time())
- 16자리: 마이크로초 (PostgreSQL TIMESTAMP)
자릿수로 단위를 먼저 판단하고 변환해야 정확한 시각이 나와요.
시나리오 2) UTC vs KST 시간대 헷갈림
한국 시간(KST)은 UTC+9. 외국 서비스 API는 대부분 UTC 기준이라 한국 사용자에겐 9시간 차이가 발생해요.
예: API 응답 `created_at: 1735689600`
- UTC 기준: 2025-01-01 00:00:00
- KST 기준: 2025-01-01 09:00:00
잘못 표시하면 '하루 차이' 버그 자주 발생. 변환기로 두 시간대 동시 확인하는 게 안전해요.
시나리오 3) 데이터베이스 쿼리 작성
PostgreSQL·MySQL에서 특정 날짜 범위 조회 시 타임스탬프 변환이 필요해요.
```sql
SELECT * FROM orders
WHERE created_at BETWEEN 1735689600 AND 1735776000;
```
이런 쿼리에서 시작·끝 시각이 정확한지 변환기로 미리 확인. 잘못 계산해서 '24시간 누락' 같은 사고가 자주 나거든요.
시나리오 4) JWT 토큰 만료 시간 확인
JWT(JSON Web Token)의 `exp` 필드는 Unix 타임스탬프예요.
```json
{
"exp": 1735776000,
"iat": 1735689600
}
```
- iat: 발급 시각
- exp: 만료 시각
토큰이 언제 만료되는지 변환기로 즉시 확인 가능. 디버깅 시 시간 동기화 문제 빠르게 파악할 수 있어요.
시나리오 5) 크론(cron) 스케줄 디버깅
Linux cron 작업이 예상과 다른 시각에 실행됐을 때 로그 타임스탬프와 cron 표현식 비교가 필수예요.
예) `0 9 * * *`은 매일 09:00 KST 실행 (서버 시간대 KST 기준).
서버가 UTC면 같은 표현식이 매일 18:00 KST 실행. 시간대 차이로 인한 미스 매치를 변환기로 빠르게 찾을 수 있어요.
Toolkio 타임스탬프 변환기 사용법
1. 변환기에 13자리·10자리 숫자 붙여넣기
2. 자동으로 단위 감지 (초·밀리초)
3. UTC·KST 두 시간대 동시 표시
4. 반대 방향(날짜 → 타임스탬프)도 가능
브라우저 안에서만 처리되니까 API 키·민감 시간 데이터 입력해도 외부 전송 안 돼요.