This function returns the year part of a timestamp based on a given time zone. 


year(timestamp, timeZone) #Output: Number



Parser expressionDescription


 %{year({issue.created}, RUN_AS_LOCAL)}



This example returns the year part of the issue creation date

If the issue was created on March 25th, 2020 23:15:30 the output would be 2020.




%{year(stringToDate("2020-01-01 00:30","Europe/Berlin"),"UTC")}


This example returns the year part of the given date, the timezone is UTC.

Due to the time zone UTC, the output will be 2019.




Parameters used in this function

ParameterInput (data type)Description
timestamp

The parameter must be valid timestamp. Usually this value is retrieved from a field (e.g. due date, created date).
timeZone

The time zone used for the calculation. 


Work days might depend on the time zone - it might be Dec 31st on the west coast of the US while at the same time it's already Monday Jan 1st in Australia. 



This function returns a



Use cases and examples




Status
Tech review

Style guide




Short description

Returns the year part of a timestamp.

Output

Label