スプレッドシートに数式を書き込む | setFormula()【GAS】

GASを使ってスプレッドシートに数式を書き込むsetFormula関数を紹介します

💡この記事でわかること

setFormula関数を使ってセルに値を書き込む方法
複数のセルに一度に数式を書き込む方法

setFormula(formula)

指定された範囲(Range)に数式を書き込みます。

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet()

// セルに数式を書き込む
sheet.getRange(1, 1).setFormula("=1+1")

実行後のスプレッドシート

公式ドキュメント

https://developers.google.com/apps-script/reference/spreadsheet/range#setformulaformula

引数

名前	型	説明
formula	String	書き込む数式

戻り値

値を書き込んだ範囲。Rangeオブジェクトで返却。

公式ドキュメント

https://developers.google.com/apps-script/reference/spreadsheet/range

setValueでの数式の書き込み

数式ではなく値を書き込むsetValueでも、数式を書き込むことができます。

「=」を先頭に付いた数式をsetValueの引数に指定して書き込むと、文字列ではなく通常の数式として書き込まれます。

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet()
  
sheet.getRange(1, 1).setValue(10)
sheet.getRange(2, 1).setValue(20)

// 数式として書き込む
sheet.getRange(3, 1).setValue("=SUM(A1,A2)")

複数セルへの書き込み

Rangeを複数セル指定した場合はどうなるんでしょうか？

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet()

// 複数セルに値を書き込む
sheet.getRange(1, 1, 2, 3).setFormula("=1+1")

実行後のスプレッドシート

Rangeに指定した2行3列分に同じ数式が格納されました。

複数のセルに同じ数式を書き込む場合は、このsetFormulaの使い方で早く処理ができます。

setFormulas(formulas)

指定された範囲(Range)に配列の数式を書き込みます。

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet()

const array = [
  ["=50+50", "=10+10", "=SUM(A1:A2)"],
  ["=15+15", "=30+30", "=SUM(B1:B2)"]
]

// 配列の数式を書き込む
sheet.getRange(1, 1, 2, 3).setFormulas(array)

実行後のスプレッドシート