---
title: date.hour() function
description: date.hour() returns the hour of a specified time. Results range from [0 - 23].
url: https://docs.influxdata.com/flux/v0/stdlib/date/hour/
estimated_tokens: 344
product: Flux
version: v0
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/date/hour/
date: '2025-03-04T18:04:02+01:00'
lastmod: '2025-03-04T18:04:02+01:00'
---

* Flux 0.37.0+

InfluxDB support

`date.hour()` returns the hour of a specified time. Results range from `[0 - 23]`.

##### Function type signature

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

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

## Parameters

### t

(Required)
Time to operate on.

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

### location

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

## Examples

* [Return the hour of a time value](#return-the-hour-of-a-time-value)
* [Return the hour of a relative duration](#return-the-hour-of-a-relative-duration)
* [Return the current hour](#return-the-current-hour)
* [Return the hour in localtime](#return-the-hour-in-localtime)

### Return the hour of a time value

```
import "date"

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

```

### Return the hour of a relative duration

```
import "date"

option now = () => 2020-02-11T12:21:03.29353494Z

date.hour(t: -8h)// Returns 7

```

### Return the current hour

```js
import "date"

date.hour(t: now())
```

### Return the hour in local time

```js
import "date"
import "timezone"

date.hour(t: r._time, location: timezone.location(name: "Europe/Berlin"))
```

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