Discord tool · 1 credit per call

Discord Timestamp Generator

Dynamic <t:unix> Tags in Every Timezone

Turn any date, Unix timestamp, or ISO string into Discord's dynamic timestamp markup with one REST call. Every viewer sees the time rendered in their own local timezone, with no manual formatting required.

All 7 stylesLocal timezoneRelative timesEdge-fast
Try the free demo View pricing
100 free credits No card required Global edge network Structured JSON

What it checks

Every style

Returns all 7 Discord timestamp styles (t, T, d, D, f, F, R) in one response.

Timezone-aware

Each user sees the time in their own local timezone automatically.

Flexible input

Accepts Unix seconds, milliseconds, or an ISO-8601 date string.

Relative times

Generates live 'in 3 days' / '2 months ago' relative markup.

Try it live

Live demo · 5 requests/min, no key needed
Click “Run review” to see the JSON response.

Quickstart

One authenticated POST request. Official JavaScript and Python SDKs available.

cURL
curl -X POST https://api.mecanik.dev/v1/client/YOUR_UUID/tools/discord-timestamp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"timestamp":"2026-04-20T16:20:00Z","format":"R"}'
JavaScript (fetch)
const res = await fetch(
  "https://api.mecanik.dev/v1/client/YOUR_UUID/tools/discord-timestamp",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer YOUR_TOKEN",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ timestamp: "2026-04-20T16:20:00Z", format: "R" }),
  },
);
const { result } = await res.json();
console.log(result.tag); // <t:1776716400:R>
Python (requests)
import requests

r = requests.post(
    "https://api.mecanik.dev/v1/client/YOUR_UUID/tools/discord-timestamp",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json={"timestamp": "2026-04-20T16:20:00Z", "format": "R"},
)
print(r.json()["result"]["tag"])  # <t:1776716400:R>

Common use cases

Event announcements

Post a start time everyone reads in their own timezone.

Reminders & schedules

Show 'starts in 2 hours' that stays accurate as time passes.

Countdowns

Drop a live relative countdown into an embed or message.

Bookings & RSVPs

Confirm dates unambiguously across a global community.

Simple, pay-as-you-go pricing

Per call
1 credits
On signup
100 free
Packs from
$5
Credits
Never expire

Pay only for what you use, with no subscription. See full pricing.

When to use the Discord timestamp generator API

If you have ever posted an event time in a Discord server, you know the pain: members are spread across timezones, and “8 PM” means six different things. Discord solves this with dynamic timestamps that render in each viewer’s local timezone, but the raw <t:UNIX:STYLE> markup is awkward to build by hand, especially when you need to convert a human date into a Unix value and pick the right style code.

The Discord timestamp generator API does it for you in one call. Send a date in whatever format you have, and get back every timestamp style ready to paste into a message, an embed field, or a webhook payload. Because relative timestamps update on their own, a single generated tag powers a live countdown that never goes stale. Pair it with the Discord API suite to build richer event, reminder, and scheduling bots from one API key.

Frequently asked questions

What is a Discord dynamic timestamp?

It is special markup in the form <t:UNIX:STYLE> that Discord renders as a date or time in each viewer's own local timezone. This Discord timestamp generator produces that markup from any date you give it.

What input formats does the timestamp generator accept?

A Unix timestamp in seconds or milliseconds, an ISO-8601 date string (like 2026-04-20T16:20:00Z), or nothing at all, in which case it uses the current time.

Which timestamp styles are returned?

All of them: short/long time, short/long date, short/long date-time, and the relative style (R) that shows 'in 3 days' or '2 months ago'. You get every style in a single response.

How much does the Discord timestamp generator API cost?

Each call costs 1 credit. Every new account gets 100 free credits, and credit packs start at $5, with no subscription and credits that never expire.

Do timestamps update automatically?

Yes. Because Discord renders the markup client-side, relative timestamps stay live, so '2 months ago' updates on its own without you editing the message.

Start building in under a minute

Create a free account and get 100 credits. No card required.

Get your API key