docs-v2/content/flux/v0.x/stdlib/date/hour.md

title	description	aliases	menu	weight	introduced
date.hour() function	The `date.hour()` function returns the hour of a specified time. Results range from `[0-23]`.	/influxdb/v2.0/reference/flux/functions/date/hour/ /influxdb/v2.0/reference/flux/stdlib/date/hour/ /influxdb/cloud/reference/flux/stdlib/date/hour/	flux_0_x_ref name parent date.hour date	301	0.37.0

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

import "date"

date.hour(t: 2019-07-17T12:05:21.012Z)

// Returns 12

Parameters

t

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

Examples

Return the hour of a time value

import "date"

date.hour(t: 2020-02-11T12:21:03.293534940Z)

// Returns 12

Return the hour of a relative duration

import "date"

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

date.hour(t: -8h)

// Returns 4