Discord 타임스탬프 자동 변환 — 디스코드 시간 표시 5가지 형식

디스코드 서버에서 이벤트 공지를 영어·한국어·일본어 사용자가 섞여 보면 시간 헷갈리잖아요. 'KST 21시' 적어도 미국 사용자는 다시 계산해야 해요. Discord 타임스탬프 코드를 쓰면 한 줄로 모든 사용자에게 각자 시간대로 자동 표시. 예시. - 입력: `<t:1746374400:F>` - 한국 사용자에게: `2026년 5월 5일 일요일 오전 9:00` - 미국 사용자에게: `Sunday, May 5, 2026 5:00 PM` - 영국 사용자에게: `Sunday, May 5, 2026 00:00` 사용자 OS 시간대에 자동 맞춤. 게임 길드·이벤트·미팅 공지에 필수. 오늘 정리할 것. 1. 타임스탬프 코드 문법 2. 5가지 형식 (t·T·d·D·F·R) 3. Unix 타임스탬프 만드는 법 4. 봇·웹훅에서 활용 5. 흔한 실수 5가지 5분이면 마스터 가능.

Discord 타임스탬프 형식. ``` <t:UNIX_TIMESTAMP:FORMAT> ``` - `<t:` — 시작 태그 - `UNIX_TIMESTAMP` — 1970-01-01 UTC부터 초 단위 (10자리) - `:FORMAT` — 표시 형식 (생략 시 기본 f) - `>` — 종료 태그 예시 — 2026년 5월 5일 0시 0분 0초 UTC. ``` <t:1746374400:F> → 2026년 5월 5일 일요일 오전 9:00 <t:1746374400:R> → 2시간 후 <t:1746374400> → 2026년 5월 5일 오전 9:00 (기본) ``` 주의. - Unix 타임스탬프는 **초 단위 10자리** — JavaScript Date.now()는 밀리초 13자리라 1000으로 나눠야 - 음수 타임스탬프(1970년 이전)도 가능 - 13자리 그대로 넣으면 표시 안 됨 (43658년 같은 미래로 인식)

시간만 짧게 표시 (24시간 또는 12시간 — 사용자 설정 따름). ``` <t:1746374400:t> ``` 결과. - 한국: `오전 9:00` - 미국 12시간 설정: `5:00 PM` - 영국 24시간 설정: `00:00` 사용처. - 게임 길드 출석 시간 — `매주 금요일 <t:1746374400:t> 모입니다` - 짧은 회의 — '내일 <t:...:t>' 날짜 정보 없이 시간만 필요할 때. 같은 날 안에서 시간만 안내할 때 깔끔.

**`:T` 긴 시간** — 초 포함. ``` <t:1746374400:T> ``` 결과: `오전 9:00:00` **`:d` 짧은 날짜**. ``` <t:1746374400:d> ``` 결과. - 한국: `2026. 5. 5.` - 미국: `5/5/2026` - 영국: `05/05/2026` **`:D` 긴 날짜**. ``` <t:1746374400:D> ``` 결과: `2026년 5월 5일` **`:f` 짧은 종합** (기본). ``` <t:1746374400:f> ``` 결과: `2026년 5월 5일 오전 9:00` **`:F` 긴 종합** — 요일 포함. 결과: `2026년 5월 5일 일요일 오전 9:00` 공식 이벤트는 `:F` 권장. 정보량 가장 많고 모든 시간대 명확.

지금 기준 상대 시간 — '5분 전·2시간 후·3일 전' 식으로 자동 갱신. ``` <t:1746374400:R> ``` 결과 (현재 시점이 2026-05-04 17:00 KST일 때). - `약 16시간 후` - 영어: `in 16 hours` 사용처. - 이벤트 카운트다운: `이벤트 시작까지 <t:1746374400:R>` - 공지 시점 표시: `공지 발표: <t:1746374400:R>` → '3일 전' - 봇 명령어 쿨다운: `다음 사용 가능: <t:1746374400:R>` 장점. 시간이 흐르면 메시지 자동 갱신 — '2시간 후' → '1시간 후' → '5분 후' → '5분 전'. 한계. 근사값 — '16시간 후'지 정확한 분 단위 X. 정확한 시간 함께 보여주고 싶으면 `<t:...:F> (<t:...:R>)`.

타임스탬프 코드 입력하려면 Unix 시간이 필요. 만드는 방법. **방법 1) 온라인 도구**. [Toolkio 타임스탬프 변환기](https://toolkio.com/tools/timestamp-converter)에 날짜·시간 입력 → Unix 자동. **방법 2) JavaScript 콘솔**. ``` Math.floor(new Date('2026-05-05T09:00:00+09:00').getTime() / 1000) // 1746374400 ``` **방법 3) Python**. ``` import datetime import time dt = datetime.datetime(2026, 5, 5, 9, 0, 0) unix = int(time.mktime(dt.timetuple())) # 1746374400 ``` **방법 4) Discord 봇**. ``` !timestamp 2026-05-05 09:00 → <t:1746374400:F> ``` HammerTime 같은 디스코드 봇 또는 자체 봇으로 자동화. 매번 손으로 변환하면 실수 잦음. 주의. 타임존 명시 필수. `'2026-05-05 09:00'`만 쓰면 로컬 시간대 기준 — 한국 PC면 KST, 미국 PC면 PT. 코드에 `+09:00` 또는 `Z` 명시.

1. **밀리초 → 초 변환 누락**: `Date.now()`는 13자리, Discord는 10자리. 1000으로 나눠야. ``` Math.floor(Date.now() / 1000) ``` 2. **타임존 누락**: `new Date('2026-05-05')` → UTC 자정. 한국 시각 명시하려면 `'2026-05-05T00:00:00+09:00'`. 3. **꺾쇠괄호 빠뜨림**: `t:1746374400:F` (X) → `<t:1746374400:F>` (O). 마크다운에서 `<>` 자동 변환되면 깨짐. 4. **형식 대소문자**: `:f` vs `:F` 다름. 소문자는 짧은, 대문자는 긴 형식. 5. **봇 메시지에 적용 안 됨**: 일부 봇은 임베드(embed) 안에서만 타임스탬프 인식. 일반 메시지·임베드 둘 다 테스트. 디버깅. 만든 타임스탬프 본인 메시지에 보내고 결과 확인 → 형식 정상이면 다른 사람에게도 정상.

[Toolkio 타임스탬프 변환기](https://toolkio.com/tools/timestamp-converter)에서 날짜·시간·타임존 선택 → Unix 자동 + Discord 형식 자동 생성. 작업 흐름. 1. 이벤트 날짜·시간 선택 (예: 2026-05-05 21:00 KST) 2. Unix 타임스탬프 자동 계산 3. Discord 형식 6개 동시 미리보기 (t·T·d·D·f·F·R) 4. 클릭으로 복사 → 디스코드에 바로 붙여넣기 장점. 봇 안 깔고 웹에서 즉시. 모바일에서도 가능. 주의. 디스코드 모바일은 일부 형식 표시 지연. PC 데스크탑이 가장 안정적. 참고. Discord API 공식 문서 — discord.com/developers/docs/reference#message-formatting-timestamp-styles. 형식 추가는 Discord 결정에 따름. 더 자세한 타임스탬프 활용은 [타임스탬프 변환 5가지 시나리오](/blog/timestamp-converter-unix-utc-5-scenarios)에서, 함정은 [Unix 타임스탬프 5가지 함정](/blog/unix-timestamp-5-pitfalls-timezone-ms)에서 이어 보세요.