now() function

now() is a function option that, by default, returns the current system time.

now() vs system.time()

now() returns the current system time (UTC). now() is cached at runtime, so all executions of now() in a Flux script return the same time value. system.time() returns the system time (UTC) at which system.time() is executed. Each instance of system.time() in a Flux script returns a unique value.

Function type signature

() => time

Examples

• Use the current UTC time as a query boundary
• Define a custom now time

Use the current UTC time as a query boundary

data
    |> range(start: -10h, stop: now())

Define a custom now time

option now = () => 2022-01-01T00:00:00Z