타임스탬프 변환 가이드 — Unix 시간을 날짜로 바꾸는 방법

개발을 하다 보면 API 응답이나 데이터베이스에서 1711843200 같은 숫자를 마주치게 돼요. 이게 대체 언제인지 바로 알 수 없어서 변환 도구가 필요한 거예요. 실제로 타임스탬프 변환이 필요한 상황은 생각보다 자주 발생해요. 서버 로그를 분석할 때, JWT 토큰의 만료 시간을 확인할 때, 외부 API 데이터를 처리할 때 등 다양한 상황에서 타임스탬프를 날짜로 바꿔야 해요. 또한 서로 다른 시스템 간에 시간 데이터를 주고받을 때 타임스탬프가 표준으로 사용돼요. 시간대(timezone)에 영향을 받지 않는 절대적인 시간값이기 때문이에요. 한국에서 보낸 시간과 미국에서 받은 시간이 시간대 차이로 달라 보이는 문제를 타임스탬프가 해결해줘요. Toolkio의 타임스탬프 변환기를 사용하면 숫자를 입력하는 즉시 날짜와 시간으로 변환된 결과를 볼 수 있어요.

각 프로그래밍 언어마다 타임스탬프를 다루는 방법이 조금씩 달라요. JavaScript에서는 Date 객체를 사용해요. new Date(1711843200 * 1000)으로 밀리초 단위로 변환해서 넘기면 돼요. JavaScript의 Date.now()는 밀리초 단위를 반환하니까 1000으로 나눠야 초 단위 타임스탬프가 돼요. Python에서는 datetime 모듈을 사용해요. datetime.fromtimestamp(1711843200)으로 로컬 시간 기준 날짜 객체를 얻거나, datetime.utcfromtimestamp()로 UTC 기준 변환이 가능해요. PHP에서는 date() 함수에 타임스탬프를 두 번째 인수로 넘기면 돼요. date('Y-m-d H:i:s', 1711843200) 형식으로 사용해요. Java에서는 Instant.ofEpochSecond(1711843200)을 사용하고, ZoneId를 지정해서 로컬 시간으로 변환할 수 있어요. 어떤 언어를 사용하든 핵심은 초 단위인지 밀리초 단위인지 확인하는 거예요. 단위를 잘못 넣으면 1970년대 날짜가 나오거나 아예 에러가 발생해요.

타임스탬프를 다룰 때 가장 자주 발생하는 실수들을 정리했어요. 첫 번째는 초와 밀리초를 혼동하는 거예요. 10자리 숫자는 초 단위, 13자리 숫자는 밀리초 단위예요. JavaScript에서 초 단위 타임스탬프를 1000 곱하지 않고 그대로 넣으면 1970년 1월 20일쯤 날짜가 나와요. 두 번째는 시간대를 무시하는 거예요. 서버에서 UTC로 저장한 타임스탬프를 클라이언트에서 로컬 시간으로 변환하지 않으면 한국 사용자에게 9시간 이전 시간이 표시돼요. 세 번째는 32비트 정수 오버플로예요. 2038년 1월 19일 이후의 타임스탬프는 32비트 정수로 표현할 수 없어요. 최신 시스템은 64비트를 사용하지만, 레거시 시스템에서는 주의가 필요해요. 네 번째는 윤초(leap second)예요. Unix 타임스탬프는 윤초를 무시하기 때문에 극도로 정밀한 시간 계산이 필요한 경우 별도 처리가 필요해요. 다만 일반 웹 개발에서는 신경 쓰지 않아도 돼요.

Toolkio의 타임스탬프 변환기는 두 가지 방향의 변환을 지원해요. 타임스탬프를 날짜로 변환하려면 숫자를 입력란에 넣기만 하면 돼요. 초 단위와 밀리초 단위를 자동으로 감지해서 올바른 날짜를 보여줘요. UTC 기준과 로컬 시간 기준 모두 표시되니까 시간대 혼동이 없어요. 반대로 날짜를 타임스탬프로 변환하는 것도 가능해요. 달력에서 원하는 날짜와 시간을 선택하면 해당하는 타임스탬프 값이 표시돼요. 현재 시간의 타임스탬프도 실시간으로 확인할 수 있어요. 개발 중에 테스트 데이터를 만들거나, API 요청에 타임스탬프를 넣어야 할 때 유용해요. 모든 처리는 브라우저에서 이루어지기 때문에 입력한 데이터가 서버로 전송되지 않아요. 민감한 시간 데이터를 다룰 때도 안심하고 사용할 수 있어요. 즐겨찾기에 추가해두면 개발할 때 빠르게 접근할 수 있어서 편리해요.