date.time() function

date.time() returns the time value of a specified relative duration or time.

date.time assumes duration values are relative to now().

Function type signature
(t: A, ?location: {zone: string, offset: duration}) => time where A: Timeable
For more information, see Function type signatures.



(Required) Duration or time value.

Use an absolute time or relative duration. Durations are relative to now().


Location used to determine timezone. Default is the location option.


Return the time for a given time

import "date"

date.time(t: 2020-02-11T12:21:03.29353494Z)// Returns 2020-02-11T12:21:03.293534940Z

Return the time for a given relative duration

import "date"

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

date.time(t: -1h)// Returns 2021-12-31T23:00:00.000000000Z

Was this page helpful?

Thank you for your feedback!

Upgrade to InfluxDB Cloud or InfluxDB 2.0!

InfluxDB Cloud and InfluxDB OSS 2.0 ready for production.