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!

The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more