GAS(GoogleAppsScript)でセルの範囲を取得する場合、getRangeメソッドを使う。

このgetRangeメソッドについて、引数の取り方に間違いやすい注意点があるので、今回はそれについて取り上げる。

一つのセルを取得する場合

getRangeメソッドの第一引数に取得したいセルの行番号、第二引数に列番号を指定する。

// C2セルを取得する場合
spreadSheet.getRange(2, 3);

セル範囲を取得する場合

範囲指定する場合は、第三引数、第四引数が必要になる。

// C2:E8セルを取得する場合
spreadSheet.getRange(2, 3, 7, 3);

第三引数には第一引数、第二引数で指定したセルを基点として取得する行数を、第四引数には取得する列数を指定する。

この時間違えやすいのが、第一・第二引数に範囲左上のセルを、第三・第四引数に範囲右上のセルを指定すると勘違いしやすい。

実際、俺はドキュメントをよく読まずに、なんとなくgetRangeメソッドを使っていたのでよくエラーに悩まされていた。