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

Syntax
 addYears(timestamp, numberOfYears, timeZone) #Output: Number
Examples
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.

Additional information

Parameters used in this function

ParameterInput (data type)Description
timestamp

NUMBER

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

NUMBER

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

TIMEZONE

The time zone used for the calculation. 

Output

This function returns a NUMBER 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