time:year() | Data Analysis 1.143.0-1.153.3

`time:year()`

Gets the year of a timestamp field.

Parameter	Type	Required	Default Value	Description
`as`	string	optional^[a]	`_year`	The name of the output field.
`field`^[b]	string	optional^[a]	`@timestamp`	The name of the input field.
`timezone`	string	optional^[a]		The time offset to use, for example, `-01:00`. If not specified, the query's offset will be used.
`timezoneField`	string	optional^[a]	`@timezone`	The name of the field containing the timezone to use, if not specified the query's timezone will be used. This is ignored if the timezone parameter is passed as well. If this is not defined the timezone offset of the query will be used.
^[a]Optional parameters use their default value unless explicitly set. ^[b]The parameter name `field` can be omitted.

Hide omitted argument names for this function

Show omitted argument names for this function

Omitted Argument Names
The argument name for field can be omitted; the following forms of this function are equivalent:
logscale Syntax
time:year("value")
and:
logscale Syntax
time:year(field="value")
These examples show basic structure only.