now() function

The now() function returns the current time (UTC) or the time defined in the now option.

*Function type: Date/Time
**Output data type:* Time

  1. now()

Examples

Use the current UTC time as a query boundary
  1. data
  2.   |> range(start: -10h, stop: now())
Return the now option time
  1. option now = () => 2020-01-01T00:00:00Z
  3. now()
  4. // Returns 2020-01-01T00:00:00.000000000Z

now() vs system.time()

now() returns the current UTC time. now() is cached at runtime, so all instances of now() in a Flux script return the same value.

system.time() returns the current system time of the host machine, which typically accounts for the local time zone. This time represents the time at which system.time() it is executed, so each instance of system.time() in a Flux script returns a unique value.

Related articles