Docly Developers
Function Updated 19 Oct 2026

addYears(datetime, years)

Adding a number of years (positive or negative value) to a specified date.

See also Compare date field with todays date Get todays date SetCulture date and number format

Parameters

datetimedatetimerequired

Date on which to add years to.

yearsnumberrequired

How many years to add (whole number, may be negative). A decimal number gives null instead of a date.

Returns

A new date; the input date is not changed. Returns null if the input is not a valid date or the number is not a whole number.

Example

Mixed HTML (or any text file) with inline JavaScript between hash signs.
#{
    var before = new Date(); // Create new date and time object
    var after = docly.addYears(before, 3); // Add years
}#
<b>Before:</b> #format(before, "dd. MMM yyyy")#<br>
<b>After:</b> #format(after, "dd. MMM yyyy")#