docs-v2/content/flux/v0/stdlib/universe/now.md

title	description	menu	weight	flux/v0/tags	introduced
now() function	`now()` is a function option that, by default, returns the current system time.	flux_v0_ref name parent identifier now universe universe/now	101	date/time	0.7.0

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

{{% caption %}} For more information, see Function type signatures. {{% /caption %}}

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