Skip to main content

EDATE

Returns the serial number of the date which comes the indicated number of months before or after the start date.

Syntax

expression.EDATE(arg1, arg2);

expression - A variable that represents a ApiWorksheetFunction class.

Parameters

NameRequired/OptionalData typeDefaultDescription
arg1RequiredApiRange | ApiName | numberA serial date number that represents the start date.
arg2RequiredApiRange | ApiName | numberThe number of months before or after the start date.

Returns

number

Example

Return the serial number of the date which comes the indicated number of months before or after the start date in a spreadsheet.

// How to get a date some months before or after the start date in a spreadsheet.

// Use function to get the serial number of the date indicated number of months before or after the start date in a spreadsheet.

const worksheet = Api.GetActiveSheet();

let func = Api.WorksheetFunction;
let ans = func.EDATE("3/16/2018", 7);

worksheet.GetRange("C1").SetValue(ans);