Discord Guide

Epoch to Discord Timestamp — Complete Guide

July 8, 2026 · 9 min read

To convert an epoch timestamp to a Discord timestamp wrap your 10-digit Unix number in Discord's syntax: <t:YOUR_EPOCH:FORMAT_CODE> — then paste it into any Discord message. Discord renders it as a dynamic tag showing the correct local time for every viewer automatically.

If you have an epoch time — a raw Unix timestamp number like 1783344824 — and you want to turn it into a Discord timestamp tag that displays correctly for everyone in your server, the process is straightforward. You wrap the number in Discord's markdown syntax, add a format code, and paste it into any message.

The result is a dynamic tag that automatically converts to each viewer's local timezone — no timezone math required on your end.

Since January 2026, Discord also added the @time mention feature — type @time in any message box, pick a date and time from the built-in picker, and Discord generates the correctly formatted Discord timestamp tag for you. But if you already have a raw epoch number you want to use directly, this guide covers exactly how to convert it.

What Is an Epoch Timestamp?

An epoch timestamp — also called a Unix timestamp or Unix time — is a single integer representing the total number of seconds elapsed since the Unix epoch: midnight on January 1 1970 at 00:00:00 UTC.

For example, 1783344824 represents a specific moment in July 2026. This number is the same everywhere on Earth simultaneously — it's timezone-neutral by design.

Discord uses this same epoch system internally for all its timestamps. When you create a Discord timestamp tag, you're giving Discord a raw epoch number and telling it how to display that moment to each viewer.

The Conversion Syntax

Every Discord timestamp tag follows this exact syntax:

<t:UNIX_TIMESTAMP:FORMAT_CODE>

To convert an epoch number to a Discord timestamp:

  1. Take your 10-digit Unix timestamp in seconds
  2. Replace UNIX_TIMESTAMP with your number
  3. Replace FORMAT_CODE with one of the 7 style flags below
  4. Paste the complete tag into any Discord message

Example using epoch 1783344824:

<t:1783344824:F>

This displays as "Tuesday, July 7, 2026 at 9:04 AM" — automatically converted to each viewer's local timezone.

All 7 Discord Format Codes

Style FlagSyntax ExampleDiscord Display Example
Short Time<t:1783344824:t>9:04 AM
Long Time<t:1783344824:T>9:04:00 AM
Short Date<t:1783344824:d>07/07/2026
Long Date<t:1783344824:D>July 7, 2026
Short Date/Time<t:1783344824:f>July 7, 2026 at 9:04 AM
Long Date/Time<t:1783344824:F>Tuesday, July 7, 2026 at 9:04 AM
Relative Time<t:1783344824:R>4 months ago / in 3 days

If you omit the format code entirely and use just <t:1783344824>, Discord defaults to the Long Date/Time format (:F).

Choosing the Right Format Code

  • Use :R for live countdowns and recency — it auto-updates as time passes
  • Use :f for most event announcements — clean date and time, easy to read
  • Use :F for formal announcements where the day of the week matters
  • Use :D for birthday lists and date-only references
  • Use :t when the date is already known and you only need the time
Pro Tip:The relative format :R is the only format that keeps changing after the message is sent. All other formats lock in a fixed display the moment Discord renders the tag. Use :R for countdowns and :f or :F for fixed event announcements.

Step-by-Step Conversion

Step 1 — Get your epoch timestamp

If you don't already have an epoch number, use the Unix Timestamp Converter to convert any date and time to a 10-digit Unix timestamp in seconds. Alternatively, use the Discord Timestamp Generator to pick your date and time visually and skip the manual conversion entirely.

Step 2 — Check the digit count

Your epoch number must be 10 digits — for example 1783344824. This confirms it's in seconds. If your number is 13 digits — for example 1783344824000 — it's in milliseconds. Delete the last 3 digits or divide by 1000 before using it. A 13-digit number in a Discord timestamp tag will display a date thousands of years in the future.

Step 3 — Wrap it in Discord syntax

Choose your format code and build the tag:

<t:1783344824:f>

Step 4 — Paste into Discord

Paste the complete tag into any Discord messageserver channel, DM, bot response, or webhook message. Discord renders it immediately as a clickable dynamic timestamp.

Step 5 — No timezone math needed

Discord automatically calculates the correct local timezone for whoever reads the message. You never need to add or subtract timezone offsets from your epoch number. The raw Unix timestamp is timezone-neutralDiscord handles the conversion entirely.

How to Get an Epoch Timestamp from a Specific Date

If you're starting from a date and time rather than an existing epoch number:

Easiest method: Use the Discord Timestamp Generator — pick your date and time from a visual calendar, select your format code, and copy the complete ready-to-paste Discord timestamp tag.

Manual method: Use the Unix Timestamp Converter — enter your date and time, get the 10-digit epoch number in seconds, then wrap it in the syntax yourself.

In JavaScript:

const epoch = Math.floor(new Date('2026-07-07T09:04:00').getTime() / 1000);
const discordTag = `<t:${epoch}:f>`;

In Python:

import datetime
dt = datetime.datetime(2026, 7, 7, 9, 4, 0)
epoch = int(dt.timestamp())
discord_tag = f"<t:{epoch}:f>"

Note the divide by 1000 in JavaScript — Date.getTime() returns milliseconds, so you must convert to seconds before wrapping in the Discord timestamp syntax.

Using Epoch Timestamps in Bots and Webhooks

If your Discord bot or webhook generates messages automatically, you can include epoch-based Discord timestamp tags directly in the message content string. Discord renders them the same way as manually typed tags.

For bot development, generate the epoch number programmatically from your event date, verify it's 10 digits (divide by 1000 if your language returns milliseconds), then interpolate it into the tag string before sending. The Discord Snowflake ID Decoder can also help if you need to extract an epoch reference date from an existing Discord message ID or user ID.

Pro Tip:When building Discord timestamp tags in code, always generate the epoch number server-side rather than client-side. A server-side timestamp is consistent regardless of the user's device clock settings — client-side timestamps can vary if the user's device clock is wrong.

Common Mistakes to Avoid

Using milliseconds instead of seconds — The single most common error. Your epoch number must be 10 digits (seconds) — not 13 digits (milliseconds). If your number is 13 digits, delete the last 3 or divide by 1000.

Adding timezone offsets manually — Never add or subtract hours from your epoch number to account for timezones. The raw Unix timestamp is timezone-neutralDiscord handles all timezone conversion automatically for each viewer.

Forgetting the colon before the format code — The syntax requires a colon between your epoch number and the format code. Missing it breaks the tag entirely and it displays as plain text.

Using the wrong case for format codes:f and :F are completely different formats — lowercase :f is Short Date/Time, uppercase :F is Long Date/Time. :t and :T also differ. The format codes are case-sensitive.

Pasting the tag in non-message fieldsDiscord timestamp syntax only renders inside message text fields — it won't display correctly in channel names, server descriptions, role names, or other non-message areas.

Using a negative epoch numberUnix timestamps can technically be negative for dates before January 1 1970 but Discord does not support negative epoch values. Only use positive 10-digit numbers.

Related Guides

Also try our free tools:

Frequently Asked Questions

Wrap your 10-digit Unix timestamp in Discord's markdown syntax: . Replace FORMAT_CODE with one of the 7 style flags:t, :T, :d, :D, :f, :F, or :R. Paste the complete tag into any Discord message and it renders as a dynamic timestamp.
Epoch time (or Unix timestamp) is a raw 10-digit integer — a count of seconds since January 1 1970. A Discord timestamp is that same number wrapped in Discord's markdown syntax with a format code that tells Discord how to display it. The epoch number is the data — the Discord timestamp tag is the display wrapper.
Your epoch number is in milliseconds (13 digits) instead of seconds (10 digits). Delete the last 3 digits from your number, or divide it by 1000, before wrapping it in the Discord timestamp syntax.
No. The raw Unix timestamp is timezone-neutral — it represents the same absolute moment everywhere on Earth. Discord automatically converts the epoch number to each viewer's local timezone when rendering the tag. Never add or subtract timezone offsets from the epoch number.
:f (Short Date/Time) is the most readable for most event announcements — it shows both the date and time cleanly. Use :F (Long Date/Time) when including the day of the week adds useful context. Use :R (Relative Time) for live countdowns that update automatically as the event approaches.
Yes — the syntax works in any Discord message text field including bot responses and webhook messages. Generate the epoch number programmatically, verify it's 10 digits in seconds, and interpolate it into the tag string before sending.
Discord defaults to the Long Date/Time format — equivalent to using :F explicitly. For example displays the same as .

Ready to generate Discord timestamps?

Open the Generator

Did You Miss These?

Discord Guide

Generate a Discord Timestamp

Free tool — all 7 formats, live Discord preview, auto timezone detection.

Open Generator →
Discord Guide8 min read

Jul 8, 2026

Discord Dynamic Timestamps — Complete Format Guide

Complete guide to all 7 Discord dynamic timestamp format codes — syntax, examples, and how to generate them without manual math.

Read Article →
Discord Guide8 min read

Jul 8, 2026

Unix Time vs UTC — What Is the Difference?

Unix time and UTC are related but not the same. Learn the exact difference, how leap seconds separate them, and when each one matters.

Read Article →
Discord Guide8 min read

Jul 8, 2026

Discord Timestamp vs Unix Timestamp — What Is the Difference?

Discord timestamps and Unix timestamps are related but serve different purposes. Learn the exact difference, when to use each one, and how they connect.

Read Article →
Discord Guide7 min read

Jul 7, 2026

How to Find Someone's Discord ID From Their Username

Step-by-step guide to finding someone's Discord ID from their username using Developer Mode and lookup tools.

Read Article →