// time formatting

Discord Timestamp Generator

Discord timestamps let you display dates and times that automatically adjust to every user's local timezone — no more "what time is that in my timezone?" questions.

What Are Discord Timestamps?

Discord timestamps are a special markdown syntax that renders a date/time in the reader's local timezone. You write a Unix timestamp wrapped in a tag, and Discord handles the rest:

<t:1717200000:F>

When sent in a message, Discord renders this as a nicely formatted date string visible to everyone in their own timezone.

Timezone-agnostic

You only need the Unix timestamp (seconds since 1 Jan 1970 UTC). Discord does all the local conversion for each viewer automatically.

All 7 Formats

Discord supports 7 different display flags. Replace UNIX with your Unix timestamp:

Flag	Syntax	Example Output	Name
`t`	`<t:UNIX:t>`	9:41 PM	Short Time
`T`	`<t:UNIX:T>`	9:41:30 PM	Long Time
`d`	`<t:UNIX:d>`	30/06/2021	Short Date
`D`	`<t:UNIX:D>`	30 June 2021	Long Date
`f`	`<t:UNIX:f>`	30 June 2021 9:41 PM	Short Date/Time
`F`	`<t:UNIX:F>`	Wednesday, 30 June 2021 9:41 PM	Long Date/Time
`R`	`<t:UNIX:R>`	2 months ago / in 3 days	Relative

Default format

Omitting the flag (<t:UNIX>) defaults to Short Date/Time (:f).

How to Use

1
Open the Timestamp Generator
Go to Disc-Tools/tools/timestamp-generator/.
2
Pick a date and time
Use the date/time picker or click a quick button (Now, Tomorrow, +1 Week).
3
Select your timezone
Choose the timezone the date/time should be interpreted in. It defaults to your local timezone.
4
Copy the format you need
Click the copy button next to any of the 7 generated formats.
5
Paste into Discord
Paste directly into a message, embed field, bot response, or anywhere Discord renders markdown.

Getting a Unix Timestamp

A Unix timestamp is the number of seconds elapsed since 1 January 1970 00:00:00 UTC. You can get one in many ways:

JavaScript

Math.floor(Date.now() / 1000) // current time
Math.floor(new Date('2025-12-25T00:00:00').getTime() / 1000)

Python

import time
int(time.time())  # current time

Bash

date +%s

Tips & Tricks

Use :R for countdowns — great for announcing events. It shows "in 3 days" or "2 hours ago" dynamically.
Combine formats — e.g. Event starts <t:UNIX:F> (<t:UNIX:R>) gives both exact date and relative time.
Works everywhere — Discord messages, bot responses, slash commands, embed fields, and even status messages.
No bot required — any user can type a timestamp manually in any Discord message.