@date

Parse a date string into a Unix timestamp, with an optional offset.

Returns: number

Syntax

@date(date offset?)

Arguments

Name	Type	Description
date	string	ISO 8601 date string or now
[offset]	string	Time offset (e.g. +1d, -2h, +3mo)

Examples

# Parse an ISO date to Unix timestamp
set $ts @date(2025-01-01)

# Current timestamp
set $now @date(now)

# With positive offset
set $future @date(2025-01-01 +1d)

# With negative offset
set $yesterday @date(2025-01-01 -1d)

See Also

• wait — wait between actions (advances time in simulations)