Login

addMonths(datetime, months) Last updated: 01. May 2026

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

See also: Compare date field with todays date Get todays date SetCulture date og number format

Parameters

Name Type Description
datetime Datetime object Date on which to add days to.
months number (int only) How many hours to add to specified datetime.

Returns

A modified date, does not modify input date.

Example

Code example (#JS)

#JS is mixed HTML (or other text file) with inline JavaScript with # starting and ending each inline statement. 
#{
    var dt = new Date(); // Create new date and time object
    
    write("Before: ");
    write(format(dt, "dd. MMM yyyy")); // output time
    write("<br>");
    
    dt = docly.addMonths(dt, 3); // Add  months
    write("After:");
    write(format(dt, "dd. MMM yyyy")); // output time
}#

Output

The #JS code above produces the output shown below: 
Before: 08. May 2026<br>After:08. Aug 2026