DiscordTimestamp Converter
✓ 링크가 복사되었습니다!
기술 구문 및 개발자 매뉴얼

디스코드 타임스탬프 구문 및 서식 완벽 가이드

서버 관리자와 봇 개발자를 위한 실전 가이드. 마크다운 태그 구조, 9가지 서식 플래그, 서머타임(DST) 오차 해결법 및 Discord.js / Python 봇 구현 예제를 안내합니다.

01 / 빠른 시작

빠른 구문 개요 및 태그 규칙

1단계: Unix 타임스탬프 계산. 이벤트 날짜와 표준 시간대를 Unix 정수 초(1970년 1월 1일 이후 경과 초)로 변환합니다.

2단계: 서식 플래그 지정. 숫자를 Discord 문법 태그로 감쌉니다: <t:UNIX초:플래그>.

3단계: Discord 채팅창에 붙여넣기. 메시지를 전송하면 모든 멤버의 채팅창에 각자의 로컬 시간으로 자동 표시됩니다.

시각적인 날짜 선택기로 간편하게 만들고 싶으신가요?

자동 표준 시간대 감지 및 실시간 미리보기가 지원되는 변환기 도구를 이용하세요.

Discord 시간 변환기 열기
02 / 구문

디스코드 타임스탬프 구문 구조

<t:1795856460:R>
1795856460 (Unix 타임스탬프)1970년 1월 1일 00:00:00 UTC 기준 경과 초입니다. 밀리초가 아닌 정수 초를 사용합니다.
R (서식 코드 플래그)표시 방식을 지정하는 한 글자 플래그입니다. 생략 시 디스코드는 기본값으로 f를 적용합니다.
03 / 서식 플래그

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>
04 / 정확도 및 서머타임

고정 약어 사용 시 1시간 오차가 발생하는 이유

가장 흔한 실수는 20시로 공지했으나 일부 사용자에게 19시나 21시로 표시되는 현상입니다.

이는 EST나 PST 같은 고정 약어가 서머타임(EDT/PDT) 변경을 반영하지 못하기 때문입니다.

팁: KST, EST 같은 고정 약어 대신 Asia/Seoul, America/New_York 같은 IANA 표준 지역명을 사용하세요.
05 / 봇 개발자

Discord.js 및 Discord.py 봇 활용법

JS / TS (Discord.js)Node.js
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>!`;
Python (Discord.py)Python 3
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)

디스코드 타임스탬프 구문 및 봇 개발 관련 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자리 정수 초를 사용해야 합니다.