---
title: date.time() function
description: date.time() returns the time value of a specified relative duration or time.
url: https://docs.influxdata.com/flux/v0/stdlib/date/time/
estimated_tokens: 1068
product: Flux
version: v0
---

# date.time() function

-   Flux 0.172.0+
-   View InfluxDB support

`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

```js
(t: A, ?location: {zone: string, offset: duration}) => time where A: Timeable
```

For more information, see [Function type signatures](/flux/v0/function-type-signatures/).

## Parameters

### t

(Required) 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-time)
-   [Return the time for a given relative duration](#return-the-time-for-a-given-relative-duration)

### Return the time for a given time

```js
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

```js
import "date"

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

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

```

[date/time](/flux/v0/tags/date/time/)