·2분 읽기
Unix 타임스탬프 SQL DB 마이그레이션 — 실전 5케이스 변환 가이드
DB 마이그레이션에서 Unix 타임스탬프를 한국시간으로 변환하는 5가지 실전 케이스를 정리했어요. PostgreSQL·MySQL·MongoDB 변환 SQL 한 줄까지 포함.
🕐
타임스탬프 변환기 바로 사용하기
Unix 타임스탬프와 날짜를 변환하세요
→
DB 마이그레이션에서 타임스탬프가 골치 아픈 이유
DB 옮길 때마다 시간 형식이 달라서 한 번씩 사고 나는 항목이 타임스탬프예요. Unix 타임스탬프(epoch)는 초 단위 정수인데, 받아들이는 쪽 DB가 datetime이면 변환 필요하고 시간대(KST/UTC) 처리도 따로 해야 해요.
실무 5케이스를 직접 다뤄본 변환 SQL과 함께 정리했어요. Toolkio 타임스탬프 변환기로 검증 후 SQL에 그대로 붙이세요.
케이스 1·2 — PostgreSQL과 MySQL
**케이스 1 — PostgreSQL: Unix → KST datetime**
```sql
SELECT to_timestamp(unix_ts) AT TIME ZONE 'Asia/Seoul' AS kst_time
FROM logs;
```
- to_timestamp() 함수로 epoch → timestamp 변환
- AT TIME ZONE으로 KST 변환
- 1714032000 → 2026-04-25 17:00:00 KST
**케이스 2 — MySQL: Unix → KST datetime**
```sql
SELECT FROM_UNIXTIME(unix_ts) AS kst_time
FROM logs;
```
- FROM_UNIXTIME() 자동 KST 변환 (서버 타임존 KST 가정)
- 서버 UTC면 CONVERT_TZ() 추가 필요
```sql
SELECT CONVERT_TZ(FROM_UNIXTIME(unix_ts), 'UTC', 'Asia/Seoul') AS kst_time
FROM logs;
```
케이스 3·4 — MongoDB와 BigQuery
**케이스 3 — MongoDB: ISODate → KST**
```javascript
db.logs.aggregate([
{ $project: {
kst_time: { $dateToString: {
date: '$created_at',
format: '%Y-%m-%d %H:%M:%S',
timezone: 'Asia/Seoul'
}}
}}
]);
```
- ISODate는 자동 UTC 저장
- $dateToString으로 KST 변환 + 포맷팅
**케이스 4 — BigQuery: Unix → KST**
```sql
SELECT TIMESTAMP_SECONDS(unix_ts) AS utc_time,
FORMAT_TIMESTAMP('%Y-%m-%d %H:%M:%S',
TIMESTAMP_SECONDS(unix_ts), 'Asia/Seoul') AS kst_str
FROM `project.dataset.logs`;
```
- TIMESTAMP_SECONDS()로 epoch → UTC
- FORMAT_TIMESTAMP() 3번째 인자에 'Asia/Seoul' 지정 → KST 출력
케이스 5 + Toolkio 활용
**케이스 5 — 마이그레이션 안전 체크 (모든 DB)**
DB 마이그레이션 시 변환된 시간이 정확한지 검증하는 5가지 체크예요.
1. **샘플 1건 확인**: Toolkio에 unix_ts 입력 → KST 결과와 SQL 결과 비교
2. **자정 경계**: UTC 자정 ↔ KST 오전 9시 정확히 나오는지
3. **윤초 처리**: 윤초가 들어간 시점 (1970~2026 누적 27초) 확인
4. **밀리초 vs 초**: 자바스크립트는 밀리초, 유닉스는 초. 1000으로 나눠야 정확
5. **시간대 누적**: 일부 DB는 변환을 두 번 해서 시간대가 18시간 차이나는 사고 발생
**Toolkio 타임스탬프 변환기 활용**
- 입력: 1714032000 (10자리 = 초) 또는 1714032000000 (13자리 = 밀리초)
- 출력: 자동으로 UTC + KST 동시 표시
- DB SQL 결과와 즉시 비교 → 1초라도 어긋나면 변환 로직 점검
프로덕션 마이그레이션 전 샘플 100건 정도 Toolkio 검증 후 진행하면 사고 거의 없어요.