now

now — the current time

now() -> time

The now function takes no arguments and returns the current UTC time as a value of type time.

This is useful to timestamp events in a data pipeline, e.g., when generating errors that are marked with their time of occurrence:

switch (
  ...
  default => yield error({ts:now(), ...})
)

super -z -c 'yield now()'

2025-01-24T16:57:20.555988Z

(at the time this document was last updated)