Documentation
A comprehensive guide to creating, using, and mastering time-related features for Discord.
What Are Discord Timestamps?
Understanding the magic behind time that just works for everyone.
Discord timestamps are a special markup that allows you to display dates and times that automatically convert to each user's local timezone. When you paste a timestamp code, Discord reads it and shows the time adjusted for the person viewing it, making it perfect for coordinating across the globe.
Timestamp Syntax
How to structure the timestamp code.
The basic syntax for a Discord timestamp is:
Where:
- 1640995200 is the specific moment in time, measured in seconds since January 1, 1970 (Unix Epoch).
- f is an optional letter that defines how the timestamp should be displayed.
Format Options
t - Short Time
e.g., 10:20 AM
Usage: <t:1640995200:t>T - Long Time
e.g., 10:20:30 AM
Usage: <t:1640995200:T>d - Short Date
e.g., 04/20/2021
Usage: <t:1640995200:d>D - Long Date
e.g., April 20, 2021
Usage: <t:1640995200:D>f - Short Date/Time
e.g., April 20, 2021 10:20 AM
Usage: <t:1640995200:f>F - Long Date/Time
e.g., Tuesday, April 20, 2021 10:20 AM
Usage: <t:1640995200:F>R - Relative Time
e.g., 2 years ago
Usage: <t:1640995200:R>Understanding Unix Timestamps
Learn how Unix timestamps work and how they power Discord's time system.
The Unix Timestamp Formula
Result is in milliseconds, divide by 1000 to get seconds
Example Conversion
Real-world example of timestamp conversion:
How to Calculate
Manual calculation steps:
- Get current date/time in UTC
- Calculate seconds since Jan 1, 1970
- Use in Discord format: <t:TIMESTAMP:FORMAT>
Discord Format Code Reference
Complete reference table for all Discord timestamp format codes with examples and use cases.
| Format | Discord Code | Example Output | Best Use Case |
|---|---|---|---|
tShort Time | <t:1640995200:t> | 4:20 PM | Quick time mentions |
TLong Time | <t:1640995200:T> | 4:20:00 PM | Precise time specifications |
dShort Date | <t:1640995200:d> | 12/31/2021 | Date-only references |
DLong Date | <t:1640995200:D> | December 31, 2021 | Formal announcements |
fShort Date/Time | <t:1640995200:f> | December 31, 2021 4:20 PM | Standard event times |
FLong Date/Time | <t:1640995200:F> | Friday, December 31, 2021 4:20 PM | Detailed schedules |
RRelative Time | <t:1640995200:R> | 3 years ago | Deadlines and countdowns |
Time Unit Conversion Reference
Essential time unit conversions for working with Unix timestamps and Discord time codes.
Seconds Conversion Table
| Time Unit | Seconds |
|---|---|
| 1 minute | 60 |
| 1 hour | 3,600 |
| 1 day | 86,400 |
| 1 week | 604,800 |
| 1 month (30 days) | 2,592,000 |
| 1 year (365 days) | 31,536,000 |
Quick Reference Examples
timestamp + 3600timestamp + 86400timestamp + 604800timestamp - 86400💡Pro Tip
When working with timestamps, always perform calculations in seconds, then convert to your desired format. This prevents floating-point errors and ensures accuracy.
Our Suite of Tools
Everything you need to manage time in your global community.
Timestamp Generator & Kitchen
Our main tool helps you create timestamps effortlessly. The integrated 'Timestamp Kitchen' is a unique feature that lets you see all available formats at once.
- Pick any date and time with an easy-to-use calendar.
- Instantly preview and copy the code for any format, from a single table.
Time Zone Converter
Planning an event across different time zones? Our converter is the perfect tool for the job.
- Select a date and time in your local timezone.
- Choose a target timezone to see the exact corresponding time for your friends.