Date & Time
date
$date[]
The $date function returns the current date as YYYY-MM-DD.
Syntax
$date
Note: This function does not take any parameters (
$date[1]is refused).
Return value
The current date in the format YYYY-MM-DD with a four-digit year and a zero-padded month and day (for example 2026-10-10). The value is read when the function runs.
The date is computed from the clock of the machine running the bot, in UTC by default. After $time[timezone] (a TZ database name such as Europe/Paris), $date returns the date in that time zone for the rest of the script.
Difference from specific functions
$date returns the full date. To get specific components of the date, use:
| Function | Returns |
|---|---|
$day |
The day of the month, without a leading zero (1-31) |
$month |
The English name of the month (for example October) |
$year |
The year (e.g., 2026) |
Examples
Simple date
The current date is $date
Date in a given time zone
$time[Asia/Tokyo]
In Tokyo it is the $date
Date in an embed
$title[Information]
$description[Current date: $date]
$footer[Server time]
Notes
- The date is based on the system clock of the server running the bot.
Try it
Paste an example into the playground to preview its message (functions that act on Discord are not run), or build the same thing with blocks.