Documentation

date.year() function

The date.year() function returns the year of a specified time.

Function type: Transformation

import "date"

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

// Returns 2019

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 year for a time value
import "date"

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

// Returns 2020
Return the year for a relative duration
import "date"

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

date.year(t: -14y)

// Returns 2006

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: