Skip to main content

GetFormulaArray

Returns an array formula from the current range.

Syntax​

expression.GetFormulaArray();

expression - A variable that represents a ApiRange class.

Parameters​

This method doesn't have any parameters.

Returns​

string | null

Example​

Read the array formula shared across a group of cells in a spreadsheet.

// How do I find out what array formula is assigned to a cell in a spreadsheet?

// Print the array formula of each cell in an array range to the worksheet in a spreadsheet.

let worksheet = Api.GetActiveSheet();
worksheet.GetRange("A1:A3").SetFormulaArray("={1;2;3}");
let value = worksheet.GetRange("A1").GetFormulaArray();
worksheet.GetRange("A4").SetValue("Array formula of the cell A1: ");
worksheet.GetRange("B4").SetValue("'" + value);
value = worksheet.GetRange("A2").GetFormulaArray();
worksheet.GetRange("A5").SetValue("Array formula of the cell A2: ");
worksheet.GetRange("B5").SetValue("'" + value);
value = worksheet.GetRange("A3").GetFormulaArray();
worksheet.GetRange("A6").SetValue("Array formula of the cell A3: ");
worksheet.GetRange("B6").SetValue("'" + value);