DiscordTimestamp Converter
✓ リンクをコピーしました!
技術構文&開発者向けマニュアル

Discordタイムスタンプ構文・書式完全ガイド

サーバー管理者とBot開発者のための技術リファレンス。マークダウン構文、全9種類の表示形式、夏時間(DST)対策、Discord.jsおよびPythonでのBot実装を解説します。

01 / クイックスタート

構文の概要とタグの基本ルール

ステップ1: Unixタイムスタンプを計算. 予定の日時とタイムゾーンをUnix秒(1970年1月1日からの経過秒)に変換します。

ステップ2: 表示形式フラグを追加. 数値をDiscordのタグ構文で囲みます: <t:UNIX秒:フラグ>。

ステップ3: Discordチャットに貼り付けて送信. メッセージに入力して送信すると、全員の端末にそれぞれの現地時間で表示されます。

日時ピッカーで直感的に作成したいですか?

タイムゾーン自動検出とリアルタイムプレビューを備えた変換ツールをご利用ください。

タイムスタンプ生成ツールを開く
02 / 構文

Discordタイムスタンプの構文構造

<t:1795856460:R>
1795856460 (Unixエポック秒)1970年1月1日00:00:00 UTCからの経過秒数。ミリ秒ではなく、常に整数秒を使用します。
R (表示スタイルフラグ)表示形式を指定する1文字のフラグ。省略した場合、Discordはデフォルトで 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)を反映しないために生じます。

解決策: America/New_York や Asia/Tokyo など、IANA公式地域名を常に指定してください。
05 / Bot開発者向け

Discord.js & Discord.pyでのBot実装方法

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)

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)を渡す必要があります。