Unix 타임스탬프 변환기

날짜/시간 값을 Unix 초, 밀리초, ISO 문자열로 변환합니다.

도구 열기 도구 목록으로
// about

도구 소개

컴퓨터는 1970년 1월 1일부터 지나간 시간을 초 단위 숫자로 기억합니다. 이것을 Unix 타임스탬프라고 부릅니다. 이 도구는 알아보기 힘든 타임스탬프 숫자를 사람이 읽을 수 있는 달력 날짜와 시간으로 바꾸어 줍니다.

사용 방법

  1. 변환하고 싶은 타임스탬프 숫자나 날짜를 입력하세요.
  2. 변환 버튼을 누르세요.
  3. 로컬 시간, UTC 시간, ISO 형식으로 변환된 결과를 확인하세요.

이 도구를 찾는 이유

  • 1700000000 같은 복잡한 숫자를 몇 년 몇 월 몇 일인지 바로 보여줍니다.
  • 초 단위(10자리)와 밀리초 단위(13자리)를 모두 자동으로 인식합니다.
  • 서버 로그나 오류 기록 분석할 때 시간을 빠르게 확인 가능합니다.

자주 묻는 질문 (FAQ)

Unix 타임스탬프란 무엇인가요?

1970년 1월 1일 0시 0분 0초(UTC)부터 현재까지 흘러간 시간을 초 단위 숫자로 센 것입니다.

10자리 숫자와 13자리 숫자의 차이는 무엇인가요?

10자리는 초(Second) 기준이고, 13자리는 밀리초(Millisecond, 1/1000초) 기준입니다.

표시되는 시간 기준은 어느 나라 기준인가요?

사용자의 현재 컴퓨터/스마트폰 위치 기준 로컬 시간과 세계 표준시(UTC)를 동시에 보여드립니다.

가이드 · 날짜·시간 · 5분 읽기

유닉스 타임스탬프 완전 정복: 초와 밀리초, 시간대, 2038년 문제

로그에 찍힌 1700000000이 언제인지, 왜 어떤 시스템은 13자리 숫자를 쓰는지, 왜 시간이 9시간씩 어긋나는지. 시간 버그의 대부분은 몇 가지 개념만 알면 피할 수 있습니다.

유닉스 타임스탬프(유닉스 시간, 에포크 시간)는 1970년 1월 1일 0시 0분 0초 UTC로부터 몇 초가 지났는지를 하나의 정수로 나타낸 것입니다. 이 기준 시점을 '유닉스 에포크'라고 부릅니다. 0은 1970-01-01 00:00:00 UTC, 1700000000은 2023-11-14 22:13:20 UTC입니다.

0           → 1970-01-01 00:00:00 UTC
1700000000  → 2023-11-14 22:13:20 UTC
1735689600  → 2025-01-01 00:00:00 UTC
2147483647  → 2038-01-19 03:14:07 UTC
유닉스 타임스탬프의 정의, 10자리와 13자리의 차이, UTC와 한국 시간(KST) 변환, 서머타임과 2038년 문제까지 개발자가 꼭 알아야 할 시간 처리 지식을 정리합니다.
가이드 읽기 →

관련 가이드

날짜·시간 4분 읽기

크론(cron) 표현식 읽고 쓰는 법: 다섯 칸의 의미와 자주 쓰는 예시

크론 표현식 다섯 필드의 의미, *, /, -, , 기호 사용법, 자주 쓰는 일정 예시, 시간대와 '일·요일' 필드에서 생기는 함정을 설명합니다.

가이드 읽기
AI로 직접 만들기

이 도구를 AI로 직접 만들어 보세요

나만의 버전이 필요하다면 아래 작업지시 프롬프트를 AI 채팅에 붙여 넣거나, 스킬 파일을 AI 코딩 에이전트에 저장하세요. 저희가 이 도구를 만들 때 정리한 기능, 예외 상황, 테스트 케이스가 그대로 담겨 있습니다.

AI 작업지시 프롬프트

Claude, ChatGPT, Gemini 같은 AI 채팅에 그대로 붙여 넣으세요.

당신은 숙련된 풀스택 웹 개발자입니다. 아래 요구사항에 맞춰 "Unix 타임스탬프 변환기" 웹 도구를 만들어 주세요.

## 목표

유닉스 타임스탬프와 사람이 읽는 날짜·시각을 서로 변환하는 도구를 만든다.

## 핵심 기능

- 타임스탬프 → 날짜, 날짜 → 타임스탬프 양방향
- 초(10자리)·밀리초(13자리) 자동 판별
- UTC, 로컬, 선택한 IANA 시간대 동시 표시
- ISO 8601 형식 출력
- 현재 시각 버튼

## 입력

- 타임스탬프 숫자 또는 날짜·시각
- 시간대

## 출력

- 변환된 날짜/타임스탬프
- ISO 8601 문자열
- 상대 시간(예: 3일 전)

## 예외 상황과 처리 규칙

- 음수(1970년 이전) 타임스탬프 지원
- 2038년 이후 값 정상 처리
- 서머타임 전환 시각의 존재하지 않는/중복 시각 안내
- 숫자가 아닌 입력 검증

## 구현 조건

- 서버 없이 브라우저에서 동작하는 단일 페이지(HTML, CSS, JavaScript)로 만들고, 입력 데이터를 외부로 전송하지 마세요.
- 모바일에서도 쓰기 편한 반응형 UI로 만들고, 입력 요소에는 레이블을 달아 키보드로도 조작할 수 있게 해 주세요.
- 결과에는 '복사' 버튼을 달고, 잘못된 입력에는 이해하기 쉬운 한국어 오류 메시지를 보여 주세요.
- 핵심 로직은 UI와 분리된 함수로 작성해 단위 테스트를 할 수 있게 해 주세요.

## 완료 기준 (테스트 케이스)

- 0 → 1970-01-01T00:00:00Z
- 1700000000 → 2023-11-14T22:13:20Z
- 1700000000000(13자리)도 같은 시각으로 인식

먼저 구현 계획을 5줄 이내로 설명한 다음 전체 코드를 작성하고, 마지막에 위 테스트 케이스를 확인하는 방법을 알려 주세요.

스킬 (SKILL.md)

Claude Code 같은 AI 코딩 에이전트에서 .claude/skills/build-timestamp-converter/SKILL.md 경로로 저장하면, 이 도구를 만들거나 고칠 때마다 다시 쓸 수 있습니다.

---
name: build-timestamp-converter
description: Unix 타임스탬프 변환기 도구를 새로 만들거나 수정할 때 사용합니다. 유닉스 타임스탬프와 사람이 읽는 날짜·시각을 서로 변환하는 도구를 만든다.
---

# Unix 타임스탬프 변환기 만들기

## 목표

유닉스 타임스탬프와 사람이 읽는 날짜·시각을 서로 변환하는 도구를 만든다.

## 작업 순서

1. 아래 필수 기능, 입력, 출력을 확인하고 빠진 정보가 있으면 먼저 질문합니다.
2. 핵심 로직을 UI와 분리된 순수 함수로 구현합니다.
3. 검증 목록의 테스트 케이스로 로직을 확인합니다.
4. 입력 폼, 결과 영역, 복사 버튼을 갖춘 반응형 UI를 만듭니다.
5. 규칙에 적힌 예외 상황을 하나씩 재현해 보고 오류 메시지를 다듬습니다.

## 핵심 기능

- 타임스탬프 → 날짜, 날짜 → 타임스탬프 양방향
- 초(10자리)·밀리초(13자리) 자동 판별
- UTC, 로컬, 선택한 IANA 시간대 동시 표시
- ISO 8601 형식 출력
- 현재 시각 버튼

## 입력

- 타임스탬프 숫자 또는 날짜·시각
- 시간대

## 출력

- 변환된 날짜/타임스탬프
- ISO 8601 문자열
- 상대 시간(예: 3일 전)

## 규칙

- 음수(1970년 이전) 타임스탬프 지원
- 2038년 이후 값 정상 처리
- 서머타임 전환 시각의 존재하지 않는/중복 시각 안내
- 숫자가 아닌 입력 검증
- 서버 없이 브라우저에서 동작하는 단일 페이지(HTML, CSS, JavaScript)로 만들고, 입력 데이터를 외부로 전송하지 마세요.

## 검증

- [ ] 0 → 1970-01-01T00:00:00Z
- [ ] 1700000000 → 2023-11-14T22:13:20Z
- [ ] 1700000000000(13자리)도 같은 시각으로 인식

AI에게 맡길 때 팁

  • 첫 줄에 사용 중인 기술(예: React, Vue, 순수 HTML)을 적으면 프로젝트에 맞는 코드를 받을 수 있습니다.
  • 코드를 받기 전에 목록의 테스트 케이스를 실제로 실행하고 결과를 보여 달라고 요청하세요.
  • 실제 비밀번호, 고객 데이터, API 키는 프롬프트에 넣지 말고 예시 값으로 바꿔 쓰세요.