Date & Time

Overview

Date and time verbs provide access to the current real-world UTC date and time.

TIME returns Unix time as a 32-bit signed integer, suitable for measuring durations and comparing points in time.

DATE and TIMESTAMP return formatted UTC strings.

Unless otherwise specified, these instructions do not modify any registers other than their destination.

Clock

TIME — Unix Time

TIME <dst>

Stores the current Unix time in the destination register.

Operands

Position Name Type Range Description
1 dst Integer register — Destination register.

Modified registers

Register Description
dst Current Unix time.

Examples

-- Get the current Unix time.
TIME r0
-- > r0 contains the number of seconds since the Unix epoch

Notes

  • Unix time is measured in seconds since 1970-01-01 00:00:00 UTC.
  • The result is a 32-bit signed integer.
  • Valid values range from -2147483648 through 2147483647, representing dates from 1901-12-13 20:45:52 UTC through 2038-01-19 03:14:07 UTC.
  • Times before the Unix epoch are represented by negative values.

Calendar

DATE — Date String

DATE <dst>

Stores the current UTC date in the destination register.

Operands

Position Name Type Range Description
1 dst String register — Destination register.

Modified registers

Register Description
dst Current UTC date.

Examples

-- Get the current date.
DATE s0
-- > s0 = "2026-08-08"

Notes

  • The date is returned in YYYY-MM-DD format.
  • The date is expressed in UTC.

TIMESTAMP — Timestamp String

TIMESTAMP <dst>

Stores the current UTC timestamp in the destination register.

Operands

Position Name Type Range Description
1 dst String register — Destination register.

Modified registers

Register Description
dst Current UTC timestamp.

Examples

-- Get a precise timestamp.
TIMESTAMP s0
-- > s0 = "2026-08-08T06:12:34.123456Z"

Notes

  • The timestamp uses ISO 8601 format.
  • The fractional seconds provide microsecond precision.
  • The Z suffix indicates UTC.