Skip to main content

SUM

Adds all the numbers in a range of cells.

Syntax

expression.SUM(args);

expression - A variable that represents a ApiWorksheetFunction class.

Parameters

NameRequired/OptionalData typeDefaultDescription
argsRequiredApiRange | ApiName | string | number | boolean | (string | number | boolean)[]Up to 255 numeric values to add. The first argument is required, subsequent arguments are optional. Arguments can be numbers, logical values, text representations of numbers, ranges, or arrays.

Returns

number

Example

Add all the numbers in a range of cells in a spreadsheet.

// Sum all values using the SUM function with numeric arguments.

// Returns the total sum of the specified values.

let worksheet = Api.GetActiveSheet();
let func = Api.WorksheetFunction;
worksheet.GetRange("A1").SetValue(func.SUM(145, 37, 236, 69, 567, 92));