This function adds or subtracts years to or from any given date.


 addYears(timestamp, numberOfYears, timeZone) #Output: Number



Parser expressionDescription


addYears({issue.created}, 10, LOCAL)


This example adds 10 years to the issue's creation date.


addYears({issue.dueDate}, -2, LOCAL)


This example subtracts 2 years from the issue's due date.


addYears({issue.cf12025}, 1, USER_LOCAL)


This example adds 1 year to a custom date-time field (with ID 12025).

Instead of the Jira server's local time this example uses the current user's time zone.



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

The offset in years. Negative values are used to subtract years.

Internally JWT multiplies this value with the time macro {YEAR} to add full years to the timestamp. Learn more about time macros.

timeZone

The time zone used for the calculation. 



This function returns a  representing a timestamp

The output can be written into any Jira field of type Date Picker ore Date Time Picker.

Another very common use case is to use this function in one of the JWT calculated date-time fields.




Use case and examples




Status
Tech review

Style guide




Short description

Adds or subtracts years to or from any given date.

Output

Label