Skip to main content
Version: v1.16.0

now

Function

now the current time

Synopsis

now() -> time

Description

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(), ...})
)

Examples

echo null | zq -z 'yield now()' -

=>

2022-02-06T18:35:35.053843Z

(at the time this document was written)