GAS(GoogleAppsScript)でセルの範囲を取得する場合、getRangeメソッドを使う。
このgetRangeメソッドについて、引数の取り方に間違いやすい注意点があるので、今回はそれについて取り上げる。
一つのセルを取得する場合
getRangeメソッドの第一引数に取得したいセルの行番号、第二引数に列番号を指定する。
// C2セルを取得する場合
spreadSheet.getRange(2, 3);
セル範囲を取得する場合
範囲指定する場合は、第三引数、第四引数が必要になる。
// C2:E8セルを取得する場合
spreadSheet.getRange(2, 3, 7, 3);
第三引数には第一引数、第二引数で指定したセルを基点として取得する行数を、第四引数には取得する列数を指定する。
この時間違えやすいのが、第一・第二引数に範囲左上のセルを、第三・第四引数に範囲右上のセルを指定すると勘違いしやすい。
実際、俺はドキュメントをよく読まずに、なんとなくgetRangeメソッドを使っていたのでよくエラーに悩まされていた。