Jake's blog

Discord Timestamps Explained: Syntax, Styles and Limits

Discord has a built-in timestamp format that shows every reader the time in their own timezone. Here's the syntax, the styles, and where it stops helping.

By Jake's Dev Team · Published


Short answer

Discord has timestamps built in. You write a small piece of code into a message and Discord renders it as a live clock that each person sees in their own timezone and their own date format. Nobody has to convert anything, and nobody has to ask "wait, what time is that for me?"

It is one of Discord's genuinely great features and most people have never heard of it. What it does not do is solve the reason half those servers need it in the first place, which is language. More on that below.

The syntax

It looks like this:

<t:1767225600>

That is the Unix timestamp (seconds since 1 January 1970) wrapped in <t: and >. You can add a style letter after a second colon:

What you want Syntax What a UK member sees
Default (date + time) <t:1767225600> 1 January 2026 00:00
Short time <t:1767225600:t> 00:00
Long time <t:1767225600:T> 00:00:00
Short date <t:1767225600:d> 01/01/2026
Long date <t:1767225600:D> 1 January 2026
Long date + time <t:1767225600:F> 1 January 2026 00:00
Relative <t:1767225600:R> in 3 hours

Seven styles, and the same one works for everyone. A member in Tokyo sees 09:00, a member in Los Angeles sees 16:00, and a member with their Discord language set to a 12-hour locale sees 4:00 PM instead of 16:00.

The relative style is the sleeper hit. <t:...:R> recalculates as time passes, so "in 3 hours" becomes "in 20 minutes" and then "2 minutes ago" without anyone editing the message. For countdowns and event pings there is nothing better.

How to get one without doing maths

You need the Unix timestamp to start with, and working that out by hand is nobody's idea of fun.

  • The built-in shortcut. Type @time in the message box and Discord offers to insert a timestamp from natural language. Where it works, it is the fastest route, though it can be fussy about phrasing and it does not always offer every style.
  • A generator. Paste a date and time into a timestamp generator and copy the code. There are a dozen of them; they are all the same tool with different fonts.

Both routes get you the code. Neither route knows what timezone your members are in, because Discord does not expose that to anyone. Which brings us to the limit.

Where timestamps stop helping

A timestamp converts a time you already know. It cannot guess the time you meant.

If you type "raid at 8pm" you still have to say 8pm where, and every member still has to work out whether that is their evening or their morning. The timestamp fixes the rendering, not the ambiguity. The fix for that is to always post the absolute time with a timestamp attached, and to lean on the relative style for the countdown.

And then there is the other half of the problem. A perfectly rendered announcement is useless to a member who cannot read the sentence around it. A timestamp tells a Portuguese speaker that the event starts in three hours. It does not tell them what the event is, what to bring, or which channel to be in. In a server that spans languages, the clock was never the only barrier.

What Jake adds to that

Jake is a Discord translation bot, so it will not generate timestamps for you. What it does is make the message around the timestamp readable by everyone in the channel:

  • Automatic channel translation in 150+ languages, applied to new messages and edits as they are posted. Set it up once with /quickstart, roughly 30 seconds.
  • Translations that post as the original sender using webhooks, so the channel reads like people talking rather than a stack of bot embeds.
  • Two-way translation, so one channel can serve both language groups instead of splitting your community in half.
  • /summarize for catching up on a busy channel you could not follow in real time.
  • 20,000 free characters a month, plus 1,000 more for every upvote. Most communities never pay.

If your server already posts times as timestamps and everyone still misses the events, the missing piece is usually comprehension, not formatting.

Try it

Add Jake to your server, run /quickstart, and pick the channels that need it. The features page covers everything on the free tier.

FAQ

Does Discord have a timestamp command? Not a slash command. It has a message format (<t:...>) and an @time shortcut in the composer. Discord renders both into each reader's local time.

Why does a timestamp show a different time for my friend? That is the point. The stored value is a fixed moment in time. Each client renders it in the reader's own timezone and date format.

My timestamp shows the wrong year. What went wrong? Almost always milliseconds instead of seconds. Unix timestamps in Discord are seconds, so a 13-digit value needs the last three digits removed.

Do I need a bot for timestamps? No. Bots can post them, and some have helper commands, but the format works for regular users.

Do timestamps work in embeds and bot messages? Yes. The same syntax renders in message content from users, bots and webhooks.

← All articles