Status
Tech review

Style guide




Short description

Returns a resultant of adding n years to the timestamp t.

Output




The function returns a resultant of adding n years to the timestamp t.


You should use this function instead of simply adding 12 * {MONTH} or 365 * {DAY}.

Negative values for n are used in order to subtract.


 addYears(number t, number n, timeZone time_zone) #Output: Number



Parser expressionDescription


addYears(t, 10, LOCAL)


timestamp t with value March 25th, 2011 23:15


The function will return a timestamp as a with the value: March 25th, 2021 23:15



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

The number defined here will be the offset in days. 

Negative values are used to substract days.

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

timeZone

The time zone used for the calculation. 



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



The function returns a .