Discord Timestamp Guide: How to Format and Generate Times

What is a Discord Timestamp?

A Discord timestamp is a powerful markdown feature that allows users to share a specific date and time that automatically adjusts to the viewer's local time zone.

Instead of typing "Server maintenance begins at 5 PM EST," which leaves global users confused and calculating offsets, you use a special syntax. The Discord app intercepts this code and renders it as exactly the correct local time for everyone reading it, whether they are in London, Tokyo, or New York.

Why Discord Uses Timestamps

Discord communities are inherently global. Attempting to schedule gaming sessions, live streams, or AMA events using a single timezone (like PST or UTC) often results in missed events and frustration.

By leveraging the underlying Unix Timestamp system, Discord shifts the burden of calculation away from the user and onto the client application. The time is transmitted as a universal absolute (seconds since the Epoch) and only translated into local human-readable text at the exact moment it is displayed on screen.

Timestamp Syntax

To format a timestamp manually, you need to use a specific markdown syntax. It looks like this:

<t:UNIX_TIMESTAMP:FORMAT>

• UNIX_TIMESTAMP is the standard 10-digit integer representing seconds since January 1, 1970.
• FORMAT is a single, optional, case-sensitive letter that tells Discord how to display the date visually.

Format Examples

If we use the timestamp 1672531199, here is how the different format modifiers change the visual output:

For a full, deep dive into these exact parameters, read our dedicated Discord Timestamp Formats guide.

Common Formatting Mistakes

• Using Milliseconds: The most frequent error. If you grab a 13-digit Unix timestamp from a Unix Timestamp Converter and paste it into Discord, it will fail or show a date far in the future. Discord only accepts 10-digit seconds.
• Wrong Case for Letters: Formatting letters are case-sensitive. Using r instead of R will not render a relative time countdown; it will likely break the syntax.
• Missing Colons: The syntax requires exactly two colons: one after the t, and one before the format letter.

Real Use Cases

Community managers and bot developers utilize this feature extensively. Some real-world applications include:

• Raid & Event Scheduling: Ensuring a guild spanning the US, EU, and Asia logs in at the exact same moment.
• Live Giveaways: Utilizing the R modifier to show exactly how much time is remaining before a contest lock.
• Ban/Mute Logs: Moderation bots use Discord timestamps so international staff members know exactly when a user's timeout expires.

See more detailed examples in our Discord Timestamp Examples repository.

Discord Timestamp Cheat Sheet

Want the easiest way to generate these codes without memorizing syntax?

Frequently Asked Questions