InfluxDB Docs

date.hour() function

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

Function type: Transformation

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(). Integers are nanosecond Unix timestamps.

Data type: Time | Duration | Integer

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
Return the hour of a nanosecond Unix timestamp
import "date"

date.hour(t: 1581423663293534940)

// Returns 12

New! Cloud or OSS?