1970년 UTC 기준의 경과시간
Unix 타임스탬프는 1970-01-01 00:00:00 UTC부터 흐른 시간을 나타냅니다. 값 0은 바로 이 기준시각입니다.
타임스탬프 자체는 특정 지역시간을 저장하지 않고 같은 순간을 로컬과 UTC로 다르게 표시합니다.
10자리와 13자리 단위 구분
현재 시점의 초 단위 값은 보통 10자리 안팎이고 밀리초 단위는 13자리 안팎입니다. 단위를 잘못 해석하면 날짜가 비정상적으로 멀어집니다.
바로툴의 자동 판단 결과를 확인하고 외부 시스템 문서에 단위가 명시돼 있다면 그 규격을 우선하세요.
- 초: seconds since epoch
- 밀리초: seconds × 1,000
- 1초 = 1,000밀리초
로컬 시간과 UTC 비교
한국 표준시는 UTC보다 9시간 빠릅니다. UTC 00:00은 한국에서 같은 날 09:00으로 표시됩니다.
서버 로그, 데이터베이스와 브라우저 화면을 비교할 때 각 시스템이 UTC를 저장하는지 로컬 시간을 저장하는지 확인하세요.
일광절약시간과 입력 형식 주의
일광절약시간을 사용하는 지역은 날짜에 따라 UTC 차이가 달라질 수 있습니다. 단순 고정 시차를 모든 날짜에 적용하면 한 시간 오차가 생길 수 있습니다.
날짜 문자열에 시간대 표시가 없으면 실행 환경이 로컬 시간으로 해석할 수 있으므로 API에는 ISO 형식과 명시적인 시간대 사용을 권장합니다.
초와 밀리초를 자릿수로 먼저 구분
Unix 타임스탬프는 1970년 1월 1일 00:00:00 UTC부터 흐른 시간을 나타내며 시스템에 따라 초 또는 밀리초를 사용합니다. 최근 날짜의 초 값은 보통 10자리, 밀리초 값은 13자리이므로 1000배 차이가 납니다. 단위가 맞지 않으면 1970년대나 매우 먼 미래로 변환될 수 있으니 숫자를 붙여 넣기 전에 API 문서와 자릿수를 함께 확인하세요.
소수점이 있는 초 값은 소수 부분이 밀리초 이하 정밀도를 뜻할 수 있고, 마이크로초·나노초를 쓰는 시스템도 있습니다. 단순히 13자리면 항상 밀리초라고 확정하지 말고 데이터베이스 열 정의와 생성 코드를 확인합니다. 로그를 공유할 때는 숫자와 함께 unit=seconds 또는 milliseconds를 표시하면 재해석 오류를 줄일 수 있습니다.
- 최근 초 단위는 대체로 10자리
- 최근 밀리초 단위는 대체로 13자리
- API 문서와 저장 열의 단위를 최종 확인
UTC와 현지시간을 같은 순간으로 읽기
타임스탬프 자체는 특정 순간을 가리키지만 화면에 표시할 때 시간대를 적용합니다. 2026-09-02 00:00 UTC는 한국 표준시로 같은 날 오전 9시입니다. UTC 값과 KST 표시값은 서로 다른 사건이 아니라 같은 순간을 다른 시계로 표현한 것입니다. 변환 결과를 보고 시간이 9시간 틀렸다고 판단하기 전에 원본이 UTC인지 로컬시간인지 확인하세요.
입력창에 시간대 표시가 없는 ‘2026-09-02 09:00’ 같은 문자열은 실행환경이 로컬시간으로 볼 수도 있고 UTC로 볼 수도 있습니다. ISO 8601 형식에서는 UTC에 Z를 붙이고, 오프셋이 있으면 +09:00처럼 명시하세요. 저장은 UTC, 사용자 표시는 지역 시간대로 처리하는 방식을 쓰면 서버와 사용자 위치가 달라도 비교하기 쉽습니다.
- 한 순간을 UTC와 지역시간으로 각각 표시 가능
- UTC 문자열에는 Z 사용
- 지역시간에는 +09:00 같은 오프셋 명시
일광절약시간과 날짜 경계에서 생기는 오류
한국은 현재 일광절약시간을 사용하지 않지만 미국·유럽 등은 계절에 따라 UTC 오프셋이 달라질 수 있습니다. ‘뉴욕 오전 9시’를 항상 UTC-5로 바꾸면 여름 기간에 한 시간 차이가 납니다. 미래 일정은 고정 오프셋보다 America/New_York 같은 시간대 이름과 최신 시간대 데이터로 변환해야 합니다.
현지 자정 전후의 사건은 UTC로 전날이나 다음 날이 될 수 있어 일별 통계가 달라집니다. 가입일, 매출일, 만료일을 집계할 때 어느 시간대의 날짜를 기준으로 하는지 정하고 SQL·분석도구·대시보드에서 같은 기준을 사용하세요. 중복되거나 존재하지 않는 일광절약시간 구간은 시스템 정책에 따라 보정될 수 있으므로 예약 업무는 테스트가 필요합니다.
- 고정 오프셋과 지역 시간대 이름을 구분
- 일별 집계의 기준 시간대 명시
- DST 전환일의 예약·반복일정 별도 테스트
변환 결과를 검증하는 실무 체크리스트
바로툴에서 단위를 선택해 변환한 뒤 원본 시스템 화면의 날짜, 알려진 사건시각, 다른 표준 변환기 중 하나와 교차 확인하세요. 날짜가 정확히 1970년 근처이거나 수천 년 뒤라면 단위 오류를 가장 먼저 의심합니다. 9시간·8시간처럼 일정한 차이는 시간대 해석, 한 시간 차이는 일광절약시간, 하루 차이는 자정 경계와 포함기준을 점검하세요.
데이터를 수정하기 전에 원본 숫자, 추정 단위, 표시 시간대와 변환식을 기록하고 복사본에서 시험합니다. 타임스탬프는 윤초를 표현하는 방식, 언어별 최대정수, 2038년 문제 같은 구현 차이도 있을 수 있습니다. 계약 만료·결제·인증처럼 중요한 시각은 서비스의 공식 시간정책과 서버 로그를 최종 기준으로 사용하세요.
- 원본 날짜와 알려진 사건시각으로 교차검증
- 오차 크기로 단위·시간대·DST 원인 구분
- 수정 전 원본과 변환규칙을 기록