일반개발

유닉스 타임스탬프를 한국 시간으로 바꾸는 법 — 10자리·13자리 구별

2026-09-25 · 3분 읽기

유닉스 타임스탬프의 개념

서버 로그나 데이터베이스, API 응답 데이터를 확인하다 보면 1700000000이나 1700000000000 같은 긴 숫자 형태를 마주하게 됩니다. 이 숫자는 특정 날짜와 시각을 컴퓨터가 다루기 편하도록 표기한 유닉스 타임스탬프(Unix Timestamp) 또는 에포크 시간(Epoch Time)입니다.

유닉스 타임스탬프는 1970년 1월 1일 00시 00분 00초 UTC(협정 세계시)를 기준점인 0으로 삼고, 그때부터 몇 초 또는 몇 밀리초가 흘렀는지를 숫자로 계산한 값입니다.

10자리와 13자리 숫자가 의미하는 것

숫자의 길이를 확인하면 사용된 시간 단위를 구별할 수 있습니다.

• 10자리 숫자: 초(Second) 단위 타임스탬프입니다. (예: 1700000000 = 2023-11-14 22:13:20 UTC)
• 13자리 숫자: 밀리초(Millisecond, 1/1,000초) 단위 타임스탬프입니다. (예: 1700000000000 = 2023-11-14 22:13:20.000 UTC)
• 16자리 숫자: 마이크로초(Microsecond, 1/1,000,000초) 단위입니다.
• 19자리 숫자: 나노초(Nanosecond, 1/1,000,000,000초) 단위입니다.

현재 시점(2020년대)을 기준으로 초 단위 숫자는 모두 10자리입니다. 밀리초 단위는 초 단위 숫자 뒤에 000과 같은 소수점 이하 단위 3자리가 추가되어 총 13자리가 됩니다.

자릿수를 잘못 계산했을 때 생기는 오류

10자리 초 단위와 13자리 밀리초 단위를 혼동하여 변환하면 날짜가 다르게 계산됩니다.

예를 들어 13자리 밀리초 값인 1700000000000을 초 단위 기준으로 변환하면 1970년으로부터 약 5만 3천 년이 지난 서기 55,800년경의 날짜가 출력됩니다. 반대로 10자리 초 단위 값인 1700000000을 밀리초 기준으로 변환하면 1970년 1월 20일 전후의 과거 날짜가 나옵니다.

따라서 타임스탬프를 해석할 때는 숫자의 자릿수를 확인해야 합니다. 실무에서 자릿수를 일일이 확인하기 번거롭다면 입력된 숫자의 단위를 자동으로 판별하는 타임스탬프 변환 를 사용하여 초와 밀리초 구분 없이 즉시 한국 시간(KST)과 UTC 기준 시각을 확인하는 것이 효율적입니다.

한국 표준시(KST) 변환과 시간대 주의점

유닉스 타임스탬프는 전 세계 공통 기준인 UTC를 기반으로 기록됩니다. 일상에서 사용하는 한국 시간으로 확인하려면 시간대(Timezone) 변환이 필요합니다.

대한민국 표준시(KST)는 협정 세계시보다 9시간 빠릅니다(UTC+9). 변환 계산을 할 때 주의할 점은 다음과 같습니다.

• UTC 기준 시각에 9시간을 더해야 한국 시간이 됩니다.
• 한국은 서머타임(일광 절약 시간제)을 적용하지 않으므로 항상 9시간 차이를 유지합니다.
• 1700000000 초를 UTC로 환산하면 2023년 11월 14일 22시 13분 20초이지만, 여기에 9시간을 더한 한국 시간은 2023년 11월 15일 오전 7시 13분 20초가 됩니다. 시간대 지정을 빠뜨리면 날짜가 달라질 수 있습니다.

타임스탬프 특수 표기 방식

특수 형식도 유의해야 합니다. 1970년 1월 1일 이전 시점은 음수 부호(-)가 붙은 타임스탬프로 표현되며, 소수점이 포함된 숫자는 소수점 앞부분이 초 단위, 뒷부분이 밀리초 이하의 시간을 나타냅니다.

대량의 시스템 로그를 대조할 때는 밀리초뿐 아니라 마이크로초 단위까지 혼재되어 표기될 수 있습니다. 이때 타임스탬프 변환 에 다양한 단위의 타임스탬프를 입력하여 현재 시점 기준 상대 시간까지 파악하면 분석 과정을 간소화할 수 있습니다.

안전하고 간편한 변환 방법

유닉스 타임스탬프를 다룰 때는 10자리(초)인지 13자리(밀리초)인지 확인한 뒤, UTC 시간에 9시간을 더해 KST로 맞추는 것이 기본 원칙입니다.

민감한 시스템 로그나 데이터베이스 시간값을 다룰 때는 외부 서버로 정보가 전송되지 않는 안전한 환경이 권장됩니다. 브라우저 내부에서만 오프라인으로 동작하는 타임스탬프 변환 를 활용하면 입력값이 외부로 나가지 않고 일시를 확인할 수 있습니다.