디스코드 타임스탬프 구문 및 서식 완벽 가이드
서버 관리자와 봇 개발자를 위한 실전 가이드. 마크다운 태그 구조, 9가지 서식 플래그, 서머타임(DST) 오차 해결법 및 Discord.js / Python 봇 구현 예제를 안내합니다.
빠른 구문 개요 및 태그 규칙
1단계: Unix 타임스탬프 계산. 이벤트 날짜와 표준 시간대를 Unix 정수 초(1970년 1월 1일 이후 경과 초)로 변환합니다.
2단계: 서식 플래그 지정. 숫자를 Discord 문법 태그로 감쌉니다: <t:UNIX초:플래그>.
3단계: Discord 채팅창에 붙여넣기. 메시지를 전송하면 모든 멤버의 채팅창에 각자의 로컬 시간으로 자동 표시됩니다.
자동 표준 시간대 감지 및 실시간 미리보기가 지원되는 변환기 도구를 이용하세요.
디스코드 타임스탬프 구문 구조
f를 적용합니다.Discord 타임스탬프 서식 플래그 레퍼런스
Discord는 날짜와 시간을 제어하는 총 9가지 서식 스타일을 지원합니다.
| 플래그 | 형식명 | Discord 표시 예시 | 마크다운 코드 |
|---|---|---|---|
| :t | 짧은 시간 | 오전 9:01 | <t:1795856460:t> |
| :T | 긴 시간 (초 포함) | 오전 9:01:00 | <t:1795856460:T> |
| :d | 짧은 날짜 | 2026. 11. 28. | <t:1795856460:d> |
| :D | 긴 날짜 | 2026년 11월 28일 | <t:1795856460:D> |
| :f | 짧은 날짜/시간 | 2026년 11월 28일 오전 9:01 | <t:1795856460:f> |
| :F | 전체 날짜/시간 | 2026년 11월 28일 토요일 오전 9:01 | <t:1795856460:F> |
| :s | 짧은 날짜/시간 | 2026/11/28 9:01 | <t:1795856460:s> |
| :S | 긴 날짜/시간 | 2026/11/28 9:01:00 | <t:1795856460:S> |
| :R | 상대적 시간 | 2시간 후 / 3일 전 | <t:1795856460:R> |
고정 약어 사용 시 1시간 오차가 발생하는 이유
가장 흔한 실수는 20시로 공지했으나 일부 사용자에게 19시나 21시로 표시되는 현상입니다.
이는 EST나 PST 같은 고정 약어가 서머타임(EDT/PDT) 변경을 반영하지 못하기 때문입니다.
Discord.js 및 Discord.py 봇 활용법
import { time, TimestampStyles } from 'discord.js';
const eventDate = new Date('2026-11-28T18:00:00Z');
// discord.js time 헬퍼 사용:
const relative = time(eventDate, TimestampStyles.RelativeTime);
// 또는 일반 템플릿 리터럴:
const epochSec = Math.floor(eventDate.getTime() / 1000);
const msg = `Event begins in <t:${epochSec}:R>!`;from datetime import datetime, timezone
import discord
from discord.utils import format_dt
dt = datetime(2026, 11, 28, 18, 0, tzinfo=timezone.utc)
# format_dt 헬퍼 사용:
relative_str = format_dt(dt, style='R')
# 또는 순수 Unix 정수값:
epoch = int(dt.timestamp())
await ctx.send(f"Event starts <t:{epoch}:R>!")디스코드 타임스탬프 구문 및 봇 개발 관련 FAQ
정규표현식 매칭, 임베드 렌더링 제한, Discord.js 및 Python 구현 규칙, @invalid-date 문제 해결에 대한 기술 정보입니다.
디스코드 타임스탬프를 매칭하는 정규표현식(Regex)은 무엇인가요?
<t:(\d+)(:[tTdDfFsSR])?> 정규식을 사용하면 Unix 정수 초와 서식 플래그를 정확히 추출할 수 있습니다.
임베드 제목이나 바닥글에서 타임스탬프가 변환되지 않는 이유는?
디스코드는 임베드 설명(description)과 필드(fields)에서만 마크다운 타임스탬프를 렌더링합니다. 제목(title)과 바닥글(footer)에서는 변환되지 않습니다.
Discord.js v14에서 타임스탬프를 생성하는 방법은?
time(new Date(), TimestampStyles.RelativeTime) 헬퍼를 사용하거나 Math.floor(Date.now() / 1000) 초 단위 정수를 포맷합니다.
Discord.py에서 타임스탬프를 생성하는 방법은?
discord.utils.format_dt(dt, style='R') 함수를 사용하여 datetime 객체를 손쉽게 디스코드 태그로 변환할 수 있습니다.
디스코드 채팅에 @invalid-date가 표시되는 이유는?
밀리초(13자리)를 입력했거나 숫자가 아닌 잘못된 값이 전달되었을 때 발생합니다. 10자리 정수 초를 사용해야 합니다.