docs-v2/content/flux/v0/stdlib/date/time.md

title	description	menu	weight	introduced
date.time() function	`date.time()` returns the time value of a specified relative duration or time.	flux_v0_ref name parent identifier date.time date date/time	101	0.172.0

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

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

Parameters

t

({{< req >}}) Duration or time value.

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

location

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

Examples

• Return the time for a given time
• Return the time for a given relative duration

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