Skip to main content

MAX

Returns the largest value in a set of values. Ignores logical values and text.

Syntax​

expression.MAX(args);

expression - A variable that represents an ApiWorksheetFunction class.

Parameters​

NameRequired/OptionalData typeDefaultDescription
argsRequirednumber | number[] | ApiRange | ApiNameUp to 255 numeric values for which the largest number will be returned. The first argument is required, subsequent arguments are optional. Arguments can be numbers, names, ranges, or arrays of numbers.

Returns​

number

Example​

Find the largest number in a set of values in a spreadsheet.

// How do I identify the highest sales amount from a list of quarterly results in a spreadsheet?

// Get the maximum value from a collection of numbers in a spreadsheet.

const worksheet = Api.GetActiveSheet();
let func = Api.WorksheetFunction;
let max = func.MAX(123, 197, 46, 354, 67, 456);
worksheet.GetRange("C1").SetValue(max);