スプレッドシートで日々のデータやリストを管理していると、「一番下の行に新しいデータをどんどん追記したい」「表全体に入っているデータだけをまとめて読み込みたい」という場面が必ず出てきます。
しかし、表のデータ件数は「今日は10件」「来週は50件」「来月は200件」というように、日々の更新によってどんどん増減しますよね。
もしプログラムの中で「5行目まで処理する」と数字を直接固定(ハードコーディング)してしまうと、データが増えるたびにGASのコードを開いて数値を書き直さなければならなくなります。これでは「自動化」とは言えません。
そこで今回学ぶのが、シート内でデータが入力されている「一番下の行番号(最終行)」をプログラムが自動で判定してくれる超重要命令 Sheet.getLastRow() です!
本連載の「フェーズ2:複数セル・配列処理と表操作」の第11回として、基礎概念から実践コード、実務で絶対に役立つ活用パターン、そして誰もが一度はハマるトラブル対処法まで、どこよりも噛み砕いて丁寧に解説します!
1. そもそも Sheet.getLastRow() とは?
Sheet.getLastRow() は、指定したシートの中で 「何らかの値やデータが入っている一番下の行の番号(数値)」 を取得する命令(メソッド)です。
基本的なコードの書き方
// シートを取得して、その最終行番号を数値で受け取る
var lastRow = sheet.getLastRow();
本連載おなじみ「家・部屋・家具」の例えで位置づけを復習!
第2回・第3回からお伝えしている「家・部屋・家具」の例えでおさらいしてみましょう。
- 【家】= スプレッドシートファイル全体(Spreadsheet)
- 【部屋】= 個別のシートタブ(Sheet) ★今回の対象!
- 【家具】= セルやセル範囲(Range)
getLastRow() は、「部屋(Sheet)」に対して呼び出す命令です。「この部屋(シート)の中で、一番下のどの家具(セル)まで使われている?」と部屋全体に問いかけて行番号を教えてもらうイメージです。
「ノートの記入済みページ」でイメージしてみよう!
100ページあるノートを1ページ目から順番に使っている状況を想像してみてください。
【ノートのイメージ】
1ページ目:[タイトル]
2ページ目:[メモ1]
3ページ目:[メモ2]
4ページ目:[メモ3] ⬅★ここが文字が書いてある一番下のページ!
5ページ目:(白紙)
6ページ目:(白紙)
...
100ページ目:(白紙)
このとき、GASに対して sheet.getLastRow() を実行すると、返ってくる値はノート全体の総ページ数(100)ではなく、文字が書かれている最後のページ番号である 4 になります。
つまり、プログラムに「今ノートの何ページ目まで使い終わっているか」を自動で教えてもらうための命令なのです!
2. STEP1:【実践】スープカレーリストの最終行を取得してみよう!
概念が掴めたところで、実際のGoogleスプレッドシートを使ってGASを動かしてみましょう!
今回は休日のお楽しみ「札幌スープカレー巡りリスト」を題材にハンズオンを進めます。
手順1:スプレッドシートの準備
- 新しいGoogleスプレッドシートを作成し、ファイル名を 「札幌スープカレー巡りリスト」 にします。
- シート名を 「中央区エリア」 に変更します。
- A1〜C5セルに、以下のようにサンプルデータを入力してください。
| A | B | C | |
| 1 | 店名 | エリア | おすすめメニュー |
| 2 | マジックスパイス | 白石区 | チキン |
| 3 | GARAKU | 中央区 | とろとろ豚角煮 |
| 4 | ラマイ | 豊平区 | ヤサイ |
| 5 | Suage+ | 中央区 | パリッと知床鶏と野菜 |
入力が終わったら、「中央区エリア」のシートタブを選択した状態にしておきます。
手順2:GASのエディタを開いてコードを入力する
- 画面上部メニューの 「拡張機能」 > 「Apps Script」 をクリックします。
- エディタが開いたら、元々入っているコードをすべて消去して真っ白にし、以下のコードをコピー&ペーストします。
function checkMyLastRow() {
// ① 今開いているスプレッドシート(家)を取得する
var ss = SpreadsheetApp.getActiveSpreadsheet();
// ② 今選択されている「中央区エリア」シート(部屋)を取得する
var sheet = ss.getActiveSheet();
// ③ シートの中でデータが入っている最終行の番号を取得する
var lastRow = sheet.getLastRow();
// ④ 取得した数値(行番号)をログ画面に出力する
Logger.log("現在、データが入力されている最終行は「" + lastRow + "行目」です!");
}
手順3:保存して実行する
- エディタ上部の 「保存アイコン(フロッピーディスク)」 をクリックします。
- 実行する関数が
checkMyLastRowになっていることを確認し、「実行」 ボタンを押します。
手順4:実行結果を確認する
画面下部の「実行ログ」に以下のように出力されれば大成功です!
情報 現在、データが入力されている最終行は「5行目」です!
GASがシートの中身をスキャンし、データが入っている一番下の行である 5 という数字をしっかり見つけてきてくれました!
3. STEP2:実務で差がつく!getLastRow() の活用パターン3選
getLastRow() で取り出した「最終行の数値」は、単体でログに表示させるだけでなく、他の命令と組み合わせることで本領を発揮します。実務の開発で毎日使うレベルの重要パターンを3つ紹介します。
活用パターン①:最終行の「次の行(lastRow + 1)」へ安全にデータを追加する
データを一番下へ追加したいとき、sheet.appendRow() という命令もありますが、「特定の列だけに書き込みたい」「見た目や書式を細かく制御したい」という場合は、getRange() と setValue() の組み合わせを使います。
ここで活躍するのが lastRow + 1 という考え方です!
function addNewCurryShop() {
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getActiveSheet();
// 1. 今の最終行を取得(現在のデータは5行目までなので「5」が取れる)
var lastRow = sheet.getLastRow();
// 2. 次に書き込むべき空き行(5 + 1 = 6行目)を計算する
var targetRow = lastRow + 1;
// 3. 6行目の各セルに新店舗の情報を書き込む
sheet.getRange(targetRow, 1).setValue("奥芝商店"); // A列(1列目)
sheet.getRange(targetRow, 2).setValue("中央区"); // B列(2列目)
sheet.getRange(targetRow, 3).setValue("やわらかチキン脚と厳選野菜"); // C列(3列目)
Logger.log(targetRow + "行目に新しいお店を追加登録しました!");
}
【ポイント】
すでにデータがある5行目を上書きすることなく、安全に「次の空いている行(6行目)」へ新しいデータをサッと追記できました!
活用パターン②:データが存在する可変範囲(A1:C5)を自動で動的指定する
「表に入っている全データをまとめて取得したい」という時、データ件数が毎日変わる場合どう指定すれば良いでしょうか?
getRange(開始行, 開始列, 行数, 列数) の引数に lastRow を渡すことで、表の大きさに合わせて自動で伸び縮みする可変範囲 を作成できます。
function getDynamicTableRange() {
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getActiveSheet();
// 最終行を取得(例: 5)
var lastRow = sheet.getLastRow();
// 「1行目・1列目(A1)」を起点に、「縦に lastRow 行分」「横に 3 列分」の範囲を取得
// ➡ つまり "A1:C5" という範囲が自動的に計算される!
var tableRange = sheet.getRange(1, 1, lastRow, 3);
// 正しく範囲が掴めているかA1表記でログ確認
Logger.log("自動認識された表の範囲: " + tableRange.getA1Notation());
}
【実行ログの例】
情報 自動認識された表の範囲: A1:C5
もし明日データが増えて100行になっても、lastRow が自動で 100 になるため、コードを1行も書き換えることなく常に表全体(A1:C100)をぴったり掴むことができます!
活用パターン③:繰り返し処理(for文)で「1行目から最終行まで」を順番に処理する
GASで大量のデータを1行ずつ判定・処理する際、プログラミングの「for文(繰り返し)」を使います。その「繰り返しの終わり」を指定するのに lastRow が必須になります。
function loopThroughRows() {
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getActiveSheet();
var lastRow = sheet.getLastRow();
// 2行目(データ開始行)から lastRow(最終行)まで1行ずつ順番に処理を繰り返す
for (var i = 2; i <= lastRow; i++) {
var shopName = sheet.getRange(i, 1).getValue(); // i行目のA列(店名)を取得
Logger.log(i + "行目のお店の名前: " + shopName);
}
}
【実行ログの例】
情報 2行目のお店の名前: マジックスパイス
情報 3行目のお店の名前: GARAKU
情報 4行目のお店の名前: ラマイ
情報 5行目のお店の名前: Suage+
データが何行あっても、最後の行まで漏れなく&無駄なく処理を走らせることができます。
4. 初心者が絶対ハマる!「4大トラップ」と完全対処法
一見シンプルで使いやすそうな getLastRow() ですが、実務や学習の途中で「あれ?思い通りの行番号が取れないぞ?」と首をかしげる現象がよく起きます。
初心者が直面しやすい4つの落とし穴と、その解決策をあらかじめ知っておきましょう!
トラップ1:見た目は空欄なのに最終行が変なところになる!(空白・書式の罠)
「データは10行目までしか入力していないのに、getLastRow() を実行するとなぜか 50 や 1000 が返ってくる…」
これはGAS初心者からのSOSで最も多いトラブルです。原因は主に以下の3つです。
- 目に見えない文字が入っている:セルの中に「半角スペース」や「全角スペース」が残っている。
- 数式で
""(空文字)を出力している:=IF(A2="","",A2)などの数式が入っていると、画面上は空欄に見えてもデータが存在するとみなされます。 - 罫線や背景色などの書式だけが残っている:過去にデータを消した際、Delキーなどで「文字だけ」を消してセル枠の装飾が残っている場合。
【解決策】
不要な行のデータ・装飾を完全に消去するには、手動で該当の行を選択して 右クリック >「行を削除」 を行うか、GASの Range.clearContent() や Range.clear() を使ってキレイに初期化しましょう。
トラップ2:特定列の最終行ではなく「シート全体の最終行」を取ってしまう
Sheet.getLastRow() は、シート上のすべての列の中で、一番下までデータが入っている行 を返します。
【シートの状況】
A列 B列 C列(メモ欄)
1行: 店名 エリア メモ
2行: GARAKU 中央区 なし
3行: ラマイ 豊平区 なし
4行: (空欄) (空欄) ※来週行く! ⬅★C列だけデータがある!
上記のようなシートで getLastRow() を実行すると、A列やB列は3行目までしかなくても、C列の4行目を参照して 4 が返ってきます。
「A列の店名が入っている最終行(3)が欲しいのに!」という場合に困ってしまいますよね。
【解決策】
「A列だけの中での最終行」を正確に取得したい場合は、将来学ぶ配列処理(getValues() でデータを取得して下から検索する)か、以下のような getNextDataCell()(Ctrl + 下矢印キーと同じ動きをする命令)を活用します。
// A列(1列目)の最終行をピンポイントで取得するテクニック
var lastRowInColumnA = sheet.getRange(sheet.getMaxRows(), 1).getNextDataCell(SpreadsheetApp.Direction.UP).getRow();
トラップ3:getLastRow()(単数形)と他のメソッドの混同
名前が似ているメソッドが多く、打ち間違いによるエラーが発生しがちです。
sheet.getLastRow()➡ データがある一番下の 行番号 を返す(戻り値:数値)sheet.getLastColumn()➡ データがある一番右の 列番号 を返す(戻り値:数値)sheet.getMaxRows()➡ シートに存在する 全体の最大行数(グリッドの総数。初期値だと1000など)を返す
「データが入っている行数」を取りたいのに間違えて sheet.getMaxRows() を使ってしまうと、データが5件しかなくても 1000 という数字が取れてしまい、処理が重くなったりエラーの原因になります。注意しましょう!
トラップ4:見出し(1行目)しかデータが入っていない場合の計算
表を作成したばかりで、1行目の見出し(「店名」「エリア」など)しか入力されていない状態のとき、getLastRow() は 1 を返します。
もし「データの件数(純粋なデータ行数)」をカウントしたくて lastRow - 1(見出しの1行分を引く計算)をしている場合、データが0件のときに 1 - 1 = 0 となり、計算結果が崩れることがあります。
【解決策】
処理を実行する前に、必ず「データが存在するかどうか」の条件分岐を入れるのが安全なコードの書き方です。
var lastRow = sheet.getLastRow();
if (lastRow <= 1) {
Logger.log("※まだデータが1件も登録されていません(見出しのみ)。");
} else {
var dataCount = lastRow - 1; // 見出しを除いた純粋なデータ件数
Logger.log("現在、登録されているデータは " + dataCount + " 件です。");
}
5. 今回のまとめと次回予告
今回は、シート内のデータの最終行を自動判別する Sheet.getLastRow() について詳しく解説しました。
今日の重要ポイント
sheet.getLastRow()はデータが存在する一番下の「行番号(数値)」を返すlastRow + 1を使うことで、既存データを壊さずに一番下の空き行へ追記できるgetRange(1, 1, lastRow, 列数)と組み合わせると、データ件数に応じて伸縮する可変範囲を自動指定できる- 見た目は空欄でもスペースや数式があると最終行として判定される点に注意する
最終行をプログラムに自動計算させられるようになると、データが増減してもコードを一切いじる必要がなくなります。一気にプロっぽい自動化ツールに近づきましたね!
さて、縦方向(行)の最終位置が掴めたら、次は 横方向(列)の最終位置 も自動で掴みたくなりますよね!
次回(第12回)は、本日の対となる命令 Sheet.getLastColumn() を解説します。 行と列の両方の末端を自動取得できるようになれば、どんな大きさの表でも一瞬でまるごと取得できるようになりますよ。ぜひお楽しみに!
