Documentation

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().

Data type: Time | Duration

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

New! Cloud or OSS?

InfluxDB OSS 2.0 now generally available!

InfluxDB OSS 2.0 is now generally available and ready for production use. See the InfluxDB OSS 2.0 release notes.

For information about upgrading to InfluxDB OSS 2.0, see: