Date and Time

These global variables provide information about the current date and time.

Basic Time Variables

Variable	Type	Description
second	String	The current second (00-59)
minute	String	The current minute (00-59)
hour	String	The current hour in 24-hour format (00-23)

Date Variables

Variable	Type	Description
day	String	The current day of the week (e.g., "Monday", "Tuesday")
day_number	Number	The current day of the month (1-31)
month	String	The current month name (e.g., "January", "February")
month_number	Number	The current month as a number (1-12)
year	Number	The current year (e.g., 2025)

Timestamps

Variable	Type	Description
timestamp	Number	A wrapper for JavaScript's Date.now()
performance	Number	A wrapper for JavaScript's performance.now()

Timezone Information

Variable	Type	Description
timezone	String	The current timezone (e.g., "UTC+1")
time.offset	Number	The current timezone offset in milliseconds
time.daylight_savings	Boolean	Whether daylight saving time is currently active

User Time Preferences

Variable	Type	Description
user.timeformat.hours	String	The user's preferred time display ("12h" or "24h")
user.timeformat.show_seconds	Boolean	Whether clocks should specify down to the second

Constants for Day and Month Names

Variable	Type	Description
days	Array	Array of day names ["Monday", "Tuesday", ...]
months	Array	Array of month names ["January", "February", ...]

Examples

// Display current time
log "Current time: " ++ hour ++ ":" ++ minute ++ ":" ++ second

// Display current date
log "Today is " + day + ", " + month + " " + day_number + ", " + year

// Format date with conditional suffix
suffix = "th"
if day_number % 10 == 1 and day_number != 11 (
  suffix = "st"
)
if day_number % 10 == 2 and day_number != 12 (
  suffix = "nd"
)
if day_number % 10 == 3 and day_number != 13 (
  suffix = "rd"
)
log "Today is the " + day_number + suffix + " of " + month

// Use the arrays to find the day of week by index
tomorrow_index = (days.index(day) + 1) % 7
log "Tomorrow is " ++ days[tomorrow_index]