Using built-in spreadsheet functions in a script

Question

I\'m using Google App Script for the first time. I\'m using it on a Google Doc spreadsheet.

I\'m trying very simple functions, just to learn the basics. For example

Answer 1

Google Apps Script still does not (1/7/20) include an API to Google Sheets native functions.

But you can set the formula (native functions) of a cell named as a named range in a spreadsheet.

Then in the GAS:

var nativeOutput = spreadsheet.getRangeByName("outputCell").getValue();

Voila! Your GAS is calling the native function in the cell.

You can send data from the GAS to the native function in the cell, by naming another cell in the sheet (or in any sheet) referred to by the formula in the other cell:

spreadsheet.getRangeByName("inputCell").setValue(inputData);

Your GAS can dynamically create these cells, rather than hardcoding them, eg:

// Create native function, its input and output cells; set input value; use native function's output value:


// Use active spreadsheet.
var spreadsheet = SpreadsheetApp.getActive();


// Name input, output cells as ranges.
spreadsheet.setNamedRange("inputCell", spreadsheet.getRange("tuples!F1"));
spreadsheet.setNamedRange("outputCell", spreadsheet.getRange("tuples!F2"));

var outputCell = spreadsheet.getRangeByName("outputCell");
var inputCell = spreadsheet.getRangeByName("inputCell");


// Set native formula that consumes input cell's value, outputting in formula's cell.
outputCell.setFormula("=WEEKNUM(inputCell)");


// Call native function by setting input cell's value for formula to consume.
// Formula sets its cell's value to formula's output value.
inputCell.setValue(15);

// Consume native function output.
var nativeOutput = outputCell.getValue();
Logger.log("nativeOutput: "+ JSON.stringify(nativeOutput)); // Logs "nativeOutput: 3"

Beware: this technique exposes the code in cells that a spreadsheet user can access/change, and other spreadsheet operations could overwrite these cells.