Guia de Sintaxe e Formatos de Timestamps do Discord
Manual de referência técnica para administradores e criadores de bots. Domine a estrutura de tags markdown, os 9 formatos oficiais, regras de horário de verão e código para bots.
Visão Geral da Sintaxe e Regras de Tags
Passo 1: Escolha a data e hora. Converta a data e o fuso horário do seu evento para segundos Unix inteiros.
Passo 2: Escolha o formato. Envolva o número na sintaxe do Discord: <t:SEGUNDOS_UNIX:FORMATO>.
Passo 3: Cole no chat do Discord. Envie a mensagem e o Discord exibirá o horário no fuso local de cada membro.
Utilize nosso conversor com detecção automática de fuso e prévia ao vivo.
Estrutura de um Timestamp do Discord
f.Todos os Formatos do Discord: Referência Completa
O Discord oferece diferentes estilos de exibição para você escolher o ideal pro seu anúncio:
| Formato | Nome do Formato | Como fica no Discord | Código Markdown |
|---|---|---|---|
| :t | Hora Curta | 09:01 | <t:1795856460:t> |
| :T | Hora Longa (com segundos) | 09:01:00 | <t:1795856460:T> |
| :d | Data Curta | 28/11/2026 | <t:1795856460:d> |
| :D | Data Longa | 28 de novembro de 2026 | <t:1795856460:D> |
| :f | Data e Hora Curta | 28 de novembro de 2026 09:01 | <t:1795856460:f> |
| :F | Data e Hora Completa | Sábado, 28 de novembro de 2026 09:01 | <t:1795856460:F> |
| :s | Data e Hora Curta | 28/11/2026 09:01 | <t:1795856460:s> |
| :S | Data e Hora Longa | 28/11/2026 09:01:00 | <t:1795856460:S> |
| :R | Tempo Relativo | em 2 horas / há 3 dias | <t:1795856460:R> |
Por que siglas fixas causam erros de 1 hora
O erro mais comum é: «Marquei meu evento para as 20h, mas teve gente que viu 19h ou 21h!».
Isso acontece ao usar siglas estáticas como EST ou PST durante o horário de verão (EDT/PDT).
Uso de Timestamps em Discord.js e Discord.py
import { time, TimestampStyles } from 'discord.js';
const eventDate = new Date('2026-11-28T18:00:00Z');
// Usando helper time do discord.js:
const relative = time(eventDate, TimestampStyles.RelativeTime);
// Ou template literal padrão:
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)
# Usando helper format_dt:
relative_str = format_dt(dt, style='R')
# Ou inteiro Unix bruto:
epoch = int(dt.timestamp())
await ctx.send(f"Event starts <t:{epoch}:R>!")Perguntas Frequentes sobre Sintaxe e Desenvolvimento de Bots
Respostas técnicas sobre regex, limitações em embeds, implementação em Discord.js / Python e solução para o erro @invalid-date.
Qual é a regex para capturar timestamps do Discord?
Use o padrão regex: <t:(\d+)(:[tTdDfFsSR])?> para extrair os segundos Unix e a flag de estilo.
Por que os timestamps não funcionam em títulos de embeds?
O Discord só renderiza timestamps na descrição e nos campos de embeds. Títulos e rodapés mostram o texto literal.
Como formatar timestamps no Discord.js v14?
Utilize a função time(): time(new Date(), TimestampStyles.RelativeTime) ou monte a string com segundos inteiros.
Como formatar timestamps no Discord.py?
Importe format_dt de discord.utils: discord.utils.format_dt(dt, style='R').
Por que aparece @invalid-date no chat do Discord?
Isso acontece ao passar milissegundos (13 dígitos) em vez de segundos Unix (10 dígitos).