Discordタイムスタンプ構文・書式完全ガイド
サーバー管理者とBot開発者のための技術リファレンス。マークダウン構文、全9種類の表示形式、夏時間(DST)対策、Discord.jsおよびPythonでのBot実装を解説します。
構文の概要とタグの基本ルール
ステップ1: Unixタイムスタンプを計算. 予定の日時とタイムゾーンをUnix秒(1970年1月1日からの経過秒)に変換します。
ステップ2: 表示形式フラグを追加. 数値をDiscordのタグ構文で囲みます: <t:UNIX秒:フラグ>。
ステップ3: Discordチャットに貼り付けて送信. メッセージに入力して送信すると、全員の端末にそれぞれの現地時間で表示されます。
タイムゾーン自動検出とリアルタイムプレビューを備えた変換ツールをご利用ください。
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でのBot実装方法
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>!")Discordタイムスタンプ構文・開発に関するよくある質問
正規表現パターン、Embedでの展開制限、Discord.jsとPythonでの実装ルール、@invalid-dateエラーの対処法を解説します。
Discordタイムスタンプを検出する正規表現(Regex)は?
<t:(\d+)(:[tTdDfFsSR])?> を使用すると、Unixタイムスタンプの秒数とスタイルフラグを正確に抽出できます。
Embedのタイトルやフッターでタイムスタンプが変換されない理由は?
Discordの仕様により、動的タイムスタンプはEmbedのdescription(説明文)とfields(フィールド値)でのみ展開されます。titleやfooterでは展開されません。
Discord.js v14でタイムスタンプを作成するには?
time(new Date(), TimestampStyles.RelativeTime) ヘルパーを利用するか、Math.floor(Date.now() / 1000) で秒数を取得して文字列を生成します。
Discord.pyでタイムスタンプを作成するには?
discord.utils.format_dt(datetime_obj, style='R') を使用すると、自動的に適切な構文にフォーマットされます。
Discordで「@invalid-date」と表示される原因は?
ミリ秒(13桁)を渡しているか、数値以外の文字が含まれている場合に発生します。10桁の整数秒(例:1726257000)を渡す必要があります。