GASのgetRangeメソッドで、セル範囲(単一・複数セル)を指定する方法

Google Apps Scriptでスプレッドシートを操作するには、以下のような4つの手順が必要です。

1. ワークブックを指定
2. ワークシートを指定
3. セル範囲を指定
4. 処理

【もっと詳しく】GASでスプレッドシートを操作する基本

START

STEP.1

ワークブックを指定

どのスプレッドシートを操作するか指定します。

• var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
• var spreadsheet = SpreadsheetApp.openById(id);
• var spreadsheet = SpreadsheetApp.openByUrl(url);

2020年6月30日GASで操作するスプレッドシートのワークブックを指定する３つの方法

STEP.2

ワークシートを指定

どのワークシートを操作するか指定します。

• var sheet = spreadsheet.getActiveSheet();
• var sheet = spreadsheet.getSheetByName(name);
• var sheet = spreadsheet.getSheets()[N-1];

2020年6月30日GASで操作するスプレッドシートのワークシートを指定する３つの方法

STEP.3

セル範囲を指定

どのセル範囲を操作するか指定します。

• var range = sheet.getRange(a1Notation);
• var range = sheet.getRange(row, column [, numrows [, numcolumns]]);

2020年6月30日GASのgetRangeメソッドで、セル範囲(単一・複数セル)を指定する方法

STEP.4

処理

値を取得/変更したり、背景色や文字色を取得/変更したり…。好き放題、いろんな処理を実行しましょう！

END

今回の記事では、ステップ3にあたるセル範囲を指定するgetRangeメソッドの使い方について紹介します。

getRangeメソッドは、ステップ4の処理を行うために欠かせないので、しっかり使い方をマスターしてください！

function myFunction() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = spreadsheet.getActiveSheet();
}

また、以降の章では、変数sheetに、GASでスプレッドシートを操作するSpreadsheetApp.Spreadsheetクラスを格納したものとして進めていきます。

// 単一セル
sheet.getRange("B1"); // B1
sheet.getRange(1, 2); // B1

// 複数セル
sheet.getRange("B1:D3");    // B1:D3
sheet.getRange(1, 2, 4);    // B1:B4
sheet.getRange(1, 2, 3, 3); // B1:D3

この記事の著者

データサイエンティスト / ブロガー

たぬ

tanu

詳しいプロフィール

プロフィール

福岡在住のデータサイエンティスト。Pythonでルーチンワークを瞬殺する仕組みを作ることやデータを視覚化することが得意です。

getRangeメソッド

セル範囲を指定するSpreadsheetApp.SpreadsheetのgetRangeメソッドには、2つの構文が存在します。

// 1.A1表記またはR1C1表記で指定する
var range = sheet.getRange(a1Notation)

// 2.数値で範囲を指定する
var range = sheet.getRange(row, column [, numrows [, numcolumns]]);

A1表記またはR1C1表記で指定する

var range = sheet.getRange(a1Notation)

基本的にはA1表記を使用したほうが直感的に分かりやすいですが、変数を絡めて使うときにはR1C1表記が役立ちます。覚えておいて損はないです。

サンプルコード

function myFunction() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = spreadsheet.getActiveSheet();
 
　// 単一セルを指定
  var range1 = sheet.getRange("B1");
  Logger.log(range1.getA1Notation()); // B1

  // 複数セルを指定
  var range2 = sheet.getRange("B1:C3");
  Logger.log(range2.getA1Notation()); // B1:C3
}

A1表記の小技

通常であれば、変数sheetにGASで操作するワークシートを保管して、その後に変数rangeにセルの範囲を保管します。

function myFunction() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();

  // シート2のB1セルを指定
  var sheet = spreadsheet.getSheetByName("シート2");
  var range = sheet.getRange("B1");
  Logger.log(range.getA1Notation()); // B1
}

しかし、A1表記を用いれば、var sheet = spreadsheet.getSheetByName("ワークシート名");としなくても、シート名を指定しそのままセル範囲を指定できるようになります。

その際、Sheet.getRange(a1Notation)ではなく、Spreadsheet.getRange(a1Notation)を使用するので、注意が必要です。

function myFunction() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();

  // シート2のB1セルを指定
  var range = spreadsheet.getRange("シート2!B1");
  Logger.log(range.getA1Notation()); // B1
}

数値で指定する

sheet.getRange(row, column [, numRows [, numColumns]]);

サンプルコード

function myFunction() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = spreadsheet.getActiveSheet();
 
　// B1セルを数値で指定
  var range1 = sheet.getRange(1, 2);
  Logger.log(range1.getA1Notation()); // B1

  // B1:B4セルを数値で指定
  var range2 = sheet.getRange(1, 2, 4);
  Logger.log(range2.getA1Notation()); // B1:B4

  // B1:D3セルを数値で指定
  var range3 = sheet.getRange(1, 2, 3, 3);
  Logger.log(range3.getA1Notation()); // B1:D3
}

さいごに

今回は、SpreadsheetApp.SpreadsheetのgetRangeメソッドについて紹介しました。

getRangeメソッドは、GASを使ってスプレッドシートを操作するときに、必ずと言っていいほど使うメソッドなので、ちゃんと使えるようにしておきましょう〜。

それでは