BuildcordDocs

Date and time

Format a time, add a length of time to it, or count down to it.

data.date works with moments and lengths of time, and keeps the answer for this run. It can't fail: something it can't read gives an empty answer, which a Comparison with is empty can check.

Settings

SettingWhat it does
DoWrite it out, add a length of time, take one away, the time until another moment, the start of its day, or write a number of seconds as a length of time.
DateThe moment to start from. Empty is now.
By, or untilA length of time to add or take away, such as 2d 6h; or for the time until, the other moment.
AsHow to write the answer. See below.
Save asThe name to keep it under. The default is when.

A moment can be written as seconds since 1970 (such as {now} or a number kept in a row), a Discord timestamp such as <t:1767312000:R>, a date and time in UTC such as 2026-11-01T19:00, or a length from now such as 2h or in 3 days.

AsLooks like
Seconds since 19701767312000, for sums and for keeping in a row
Relative"in 3 days", in each reader's language
Date and time, Date, TimeIn each reader's own time zone
Text in UTC1 Jan 2026, 18:00 UTC
Day of the weekThursday
ISO 86012026-01-01T18:00:00Z
A length of time2d 3h, for the time until another moment

Ways out

out.

Produces

{temp.name}, using the name from Save as.

Example

A giveaway that ends in a week: Add a length of time of 7d to now, written as seconds, kept in the giveaway's row as endsAt. The message says Ends <t:{row.endsAt}:R>, and a Wait until {row.endsAt} picks the winner.

On this page