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

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

💡この記事でわかること

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

setValue(value)

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

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

// セルに値を書き込む
sheet.getRange(1, 1).setValue("りんご")

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

公式ドキュメント

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

引数

名前	型	説明
value	Object	書き込む値

戻り値

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

公式ドキュメント

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

数式の書き込み

「=」を先頭に付いた数式を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).setValue("りんご")

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

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

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

setValues(values)

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

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

const array = [
  ["みかん", "100円", 10],
  ["りんご", "200円", 15]
]

// 配列の値を書き込む
sheet.getRange(1, 1, 2, 3).setValues(array)

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