Gerador de timestamp do Discord

Como funciona um timestamp do Discord?

Um timestamp do Discord é um pequeno código no formato <t:1618953630:R> que o Discord troca por uma data legível. O número é um tempo Unix: os segundos passados desde 1º de janeiro de 1970 à meia-noite, no horário UTC. A letra do final escolhe o formato. A grande vantagem: o código indica um instante exato, e não um horário “da sua cidade”. Cada pessoa vê esse instante convertido para o próprio fuso horário e no idioma do seu app. Um encontro marcado para as 21h em São Paulo aparece às 20h para um amigo em Manaus, sem ninguém precisar fazer conta. O tempo relativo (“em 3 horas”) ainda se atualiza sozinho. É ideal para avisar de uma call, um evento do servidor, um lançamento ou o fim de um sorteio.

Os 7 formatos de timestamp do Discord

A última letra do código decide como ele aparece. Para uma pessoa em Brasília, o número 1618953630 dá: t, a hora curta (18:20); T, a hora com segundos (18:20:30); d, a data curta (20/04/2021); D, a data por extenso (20 de abril de 2021); f, a data por extenso e a hora (20 de abril de 2021 18:20), o formato padrão quando não se escreve nenhuma letra; F, o dia da semana com a data e a hora (terça-feira, 20 de abril de 2021 18:20); e R, o tempo relativo, como “em 2 horas” ou “há 5 anos”. O texto exato muda um pouco conforme o idioma do app de cada pessoa. Para um anúncio, combine F e R: a data completa seguida da contagem regressiva. O Discord também documenta dois formatos mais recentes, s e S (data curta e hora, sem ou com segundos), que você pode escrever à mão.

O meu timestamp do Discord aparece errado ou com a data errada

Quase sempre a causa é uma destas quatro. Primeiro, o número está em milissegundos: um número de 13 dígitos, como o que Date.now() devolve em JavaScript, gera uma data inválida, porque o Discord espera segundos (10 dígitos); divida por 1.000. Segundo, o código está entre crases ou dentro de um bloco de código: o Discord não interpreta mais nada e mostra o texto puro. Terceira armadilha, um erro de digitação: o formato deve ser exatamente <t:1618953630:R>, com os sinais de menor e maior, os dois-pontos e sem nenhum espaço. Por fim, alguns lugares não aceitam formatação, como o apelido ou o nome de um canal. Cole o seu código na aba “Ler um timestamp”: a ferramenta decodifica e aponta o erro.

Um horário em outro fuso e os bots do Discord

Para marcar algo num horário que não é o do seu aparelho, por exemplo 20h em Lisboa, escolha primeiro o fuso (Europe/Lisbon) e depois digite a hora. A ferramenta calcula o tempo Unix certo, inclusive perto das mudanças de horário de verão: ela avisa quando o horário escolhido não existe ou existe duas vezes. Para descobrir a data escondida num código, use o modo “Ler um timestamp”. Quem desenvolve bots encontra a mesma sintaxe: o discord.js oferece a função time() e o discord.py a função discord.utils.format_dt, que geram esses códigos a partir de uma data. Para formatar a mensagem em volta do timestamp, experimente também o “Texto colorido no Discord”; para comparar os horários de várias cidades, o “Conversor de fuso horário”.