K
Docs
πŸ•

Format Time

base.format_timeBase SetUtility

Formats a date/time spark into human-readable text, ISO, a custom pattern, or Discord's native `<t:unix:style>` timestamps (t, T, d, D, f, F, R). Leave the input empty to use the current time when the flow runs.

When to use this
  • β†’Discord mode outputs `<t:unix:style>` β€” paste {{when}} into a Reply and Discord renders it live
  • β†’Use locale mode for plain English dates; custom mode supports YYYY, MM, DD, HH, mm, ss
  • β†’Leave timestamp empty to format the moment the flow runs

On the canvas

This is what Format Time looks like when you place it on your flow. Each field below is something you configure in the inspector panel.

πŸ•
Format Time
base.format_time
Utility
input
{{timestamp}} or leave empty for now
moderequired
select…
discordStyle
select…
locale
en-US
dateStyle
select…
timeStyle
select…
pattern
YYYY-MM-DD HH:mm
timezone
America/New_York
asrequired
when (becomes a Spark!)

Config fields

FieldTypeReqWhat it does
input
{{timestamp}} or leave empty for now
textβ€”Timestamp ⏱️
modeselectyesFormat mode
discordStyleselectβ€”Discord style
locale
en-US
textβ€”Locale
dateStyleselectβ€”Date style
timeStyleselectβ€”Time style
pattern
YYYY-MM-DD HH:mm
textβ€”Custom pattern
timezone
America/New_York
textβ€”Timezone (optional)
as
when (becomes a Spark!)
textyesName the result ✨

Output ports

outputMoves on with the formatted time available as a Spark
πŸ“

In TypeScript, this would be…

Not something you need to write β€” just a look at what Kitcord does for you.

TypeScript
const unix = Math.floor(Date.parse(isoOrMs) / 1000);
// Discord: <t:${unix}:R>  (relative β€” "in 2 hours")
// Locale: new Intl.DateTimeFormat("en-US", { dateStyle: "medium", timeStyle: "short" }).format(date)