【GAS入門#12】表の横幅(最終列)を自動判別!Sheet.getLastColumn()の使い方と活用法

スプレッドシートで業務改善やデータ管理を行っていると、「縦方向(行)」だけでなく「横方向(列)」にもどんどん項目が増えていく表を扱う機会が多いですよね。

前回(第11回)は、縦方向に伸びる表の最終行を判定する Sheet.getLastRow() について詳しく学びました。

今回学習するのは、その「横バージョン」にあたる Sheet.getLastColumn()(ゲット・ラスト・コラム) です!

この命令をマスターすると、表の縦の長さ(高さ)だけでなく、横の幅(横幅)もGASがプログラム内で自動判別できるようになります。データが増減してもコードを書き直す必要がなくなり、完全に動的な全自動処理が組めるようになりますよ。

プログラミングが初めての方でも挫折しないよう、1行ずつ噛み砕いて丁寧に解説していきますね!

1. そもそも Sheet.getLastColumn() とは?

Sheet.getLastColumn() は、指定したシート(部屋)の中で 「何らかのデータ(文字や数値など)が入っている一番右端の列番号」を数値(1, 2, 3…)で教えてくれる命令(メソッド) です。

「家・部屋・家具」の例えでおさらい!

本連載でおなじみの例えで整理してみましょう。

  • 【家】= スプレッドシートファイル全体(SpreadsheetApp.getActiveSpreadsheet())
  • 【部屋】= 個別のシートタブ(ss.getActiveSheet()) ★今回の対象!
  • 【家具】= セル・セル範囲(sheet.getRange())

getLastColumn() は、「部屋(シート)全体を見渡して、一番右側の壁から数えてどこまで家具(データ)が並んでいるか」 を測るメジャーのような役割を果たします。

コードの基本構造

// 1. 部屋(シート)を取得する
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();

// 2. そのシートの一番右端(最終列)の番号を取得する
var lastColumn = sheet.getLastColumn();

getLastRow() と getLastColumn() の違いを整理しよう

命令(メソッド)取得するもの判定する方向返ってくる値のイメージ
Sheet.getLastRow()データが入っている一番下の行番号縦方向(行・高さ)10(=10行目)
Sheet.getLastColumn()データが入っている一番右の列番号横方向(列・横幅)5(=5列目 / E列)

💡 超重要ポイント:返ってくるのは「アルファベット」ではなく「数字」!

スプレッドシートの列といえば「A列、B列、C列…」というアルファベットを思い浮かべる方が多いですよね。

しかし、getLastColumn() が返す結果は 「1, 2, 3, 4, 5…」という「数字(数値型)」 です!

  • A列 = 1
  • B列 = 2
  • C列 = 3
  • D列 = 4
  • E列 = 5

「なぜアルファベットじゃないの?」と疑問に思うかもしれませんが、プログラミングでは「数字」で取得できたほうが、計算したり範囲を指定したりするときに圧倒的に扱いやすいためです。この理由は後ほど詳しく解説しますね!

2. STEP1:準備!「札幌スープカレー トッピング管理表」を作成しよう

まずは、GASから操作するための練習用シートを作成してみましょう。

今回は、店舗ごとにトッピングのバリエーションが横に広がっていく「札幌スープカレー トッピング管理表」を題材にします。

作成手順

  1. ブラウザで新しいGoogleスプレッドシートを開きます。
  2. ファイル名を 「札幌スープカレー管理簿」 に変更します。
  3. 画面下のシートタブ名を 「トッピング管理」 に変更します。
  4. 以下のように、A列からE列までデータを入力してください。
ABCDE
1店舗名メイン具材トッピング1トッピング2トッピング3
2スープカレーGARAKUやわらかチキン legブロッコリーチーズうずら
3マジックスパイスチキンヤングコーンきくらげ
4奥芝商店海老スープチキン舞茸おくらチーズオンライス

入力が完了したら、データが入力されている一番右端が E列(=5列目) になっていることを確認し、「トッピング管理」シートを開いた状態(アクティブ)にしておきます。

3. STEP2:【実践】最終列の番号を取得してログに表示してみよう!

それでは、実際のコードを書いて getLastColumn() の動きを確認してみましょう。

1. コードを入力する

スプレッドシートの上部メニューバーから 「拡張機能」>「Apps Script」 を開き、エディタ画面のコードをすべて消して以下を貼り付けます。

function checkLastColumn() {
  // ① 開いているスプレッドシートと「トッピング管理」シートを取得
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();
  
  // ② データが入っている一番右端の列番号(数字)を取得する
  var lastColumn = sheet.getLastColumn();
  
  // ③ 取得した結果をログ画面に出力する
  Logger.log("現在データが入っている最終列は:" + lastColumn + " 列目です!");
}

2. 実行手順と結果の確認

  1. 画面上部の 「保存アイコン(フロッピーディスク)」 をクリックします。
  2. 実行する関数が checkLastColumn になっていることを確認し、「実行」 ボタンをクリックします。
  3. 画面下部の「実行ログ」を確認します。
情報    現在データが入っている最終列は:5 列目です!

E列の位置にあたる 5 という数字がしっかりと取得できましたね!

💡 ここで実験!横にデータが増えたらどうなる?

スプレッドシートの画面に戻り、F1セル に「トッピング4」、F2セル に「揚げナス」と入力してみましょう。

その状態でもう一度GASのエディタで「実行」ボタンを押すと…?

情報    現在データが入っている最終列は:6 列目です!

コードを1文字も変えていないのに、GASが自動で「あ、一番右端がF列(6列目)に増えたな!」と判別してくれました!これが getLastColumn() の大きな強みです。

4. STEP3:実務で9割使われる黄金パターン!getLastRow() × getLastColumn() の組み合わせ

getLastColumn() を単体で使うことは実は少なく、実務では第11回で学んだ getLastRow()(最終行)とセットで使うケースが全体の9割以上 を占めます。

なぜなら、業務で扱う表は「縦(行)にも横(列)にもデータが伸び縮みする」からです。

表全体の範囲(A1〜右下)を動的に掴むコード

第4回で解説した Sheet.getRange(開始行, 開始列, 行数, 列数) の数値指定構文と組み合わせることで、表全体をピッタリ囲む範囲(Range)を一瞬で取得 できます。

function getEntireTableRange() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();
  
  // 1. 縦の最終行(高さ)を取得する ➡ 例:4行目までデータがあるなら「4」
  var lastRow = sheet.getLastRow();
  
  // 2. 横の最終列(幅)を取得する ➡ 例:E列までデータがあるなら「5」
  var lastColumn = sheet.getLastColumn();
  
  // 3. (1行目, 1列目) を起点に、縦 lastRow行分、横 lastColumn列分の範囲を掴む!
  var tableRange = sheet.getRange(1, 1, lastRow, lastColumn);
  
  // 4. 取得した範囲がどこからどこまでかを A1表記で確認してみる
  Logger.log("掴んだ表全体の範囲:" + tableRange.getA1Notation());
}

実行結果

情報    掴んだ表全体の範囲:A1:E4

図解で納得!sheet.getRange(1, 1, lastRow, lastColumn) の仕組み

この4つの数字の指定方法は、初心者が最も混乱しやすいポイントです。構造を分解してみましょう。

sheet.getRange( 開始行, 開始列, 行数(高さ), 列数(横幅) );

今回の表に当てはめると、以下のようになります。

  1. 第1引数(開始行)1 ➡ 1行目からスタート
  2. 第2引数(開始列)1 ➡ 1列目(A列)からスタート(=起点セルは A1)
  3. 第3引数(行数)lastRow ➡ 縦方向に 4 行分 下へ伸ばす
  4. 第4引数(列数)lastColumn ➡ 横方向に 5 列分 右へ伸ばす

結果として、「A1セルから始まり、縦4行・横5列の四角いブロック(A1:E4)」 が寸分の狂いもなく自動で選択されます!

今後、店舗データが100行に増えようが、トッピングが10列に増えようが、この1行を書くだけで常に表全体を正しくキャッチできるようになります。

5. 初心者が絶対につまずく!4大トラップと解決策

getLastColumn() を使う際、初心者がハマりやすいエラーやトラブルを4つ厳選しました。ここでしっかり予習しておきましょう!

トラップ1:アルファベット(”E”など)が返ると誤解してエラーになる

一番多い間違いが、getLastColumn() で "E" という文字列が返ってくると思い込み、以下のように A1表記を作ろうとしてしまうパターンです。

// ✕ 間違った書き方(エラーになる)
var lastCol = sheet.getLastColumn(); // 「5」が返ってくる
var range = sheet.getRange("A1:" + lastCol + "4"); // "A1:54" になってしまい壊れる!

【解決策】

getLastColumn() が返すのは文字列の "E" ではなく、数値の 5 です。

A1表記の文字列を作ろうとするのではなく、sheet.getRange(1, 1, lastRow, lastColumn) という「数値で範囲を指定する構文」を使いましょう!

トラップ2:見た目は空欄なのに最終列が想定より大きくなる

「文字が入っているのはE列までなのに、なぜか getLastColumn() が 8(H列)を返してくる…」という現象がよく起こります。

【主な原因】

  1. 見えない文字(半角スペースなど)が入っている
    • F列やG列のセルに、うっかりスペースキーを押して入力した「目に見えない空白文字」が残っている。
  2. 数式で ""(空文字)を表示している
    • =IF(A1="","",A1) などの数式が入っていると、画面上は空欄に見えてもGASは「データ(数式)が入っている列」とみなします。

【解決策】

余分な列のデータをドラッグして選択し、右クリックから 「列を削除」 するか、第8回で学ぶ Range.clearContent() でセルの中身を完全に消去しましょう。

トラップ3:結合セルがある場合のカウントルール

例えば、1行目の見出しで「C1:E1」のセルが結合されて「トッピング一覧」と書かれていたとします。

この場合、getLastColumn() は 「結合されたセルのうち、一番右端の列(=E列 / 5列目)」 を最終列として判定します。結合セルがあっても右端が途切れてしまう心配はありませんので安心してください。

トラップ4:実行する対象を間違えて TypeError になる

ついついやってしまうのが、呼び出す対象のミスです。

// ✕ 間違い1:ファイル全体(Spreadsheet)に対して実行している
var ss = SpreadsheetApp.getActiveSpreadsheet();
var col = ss.getLastColumn(); // TypeError: ss.getLastColumn is not a function

// ✕ 間違い2:特定セル(Range)に対して実行している
var range = sheet.getRange("A1");
var col = range.getLastColumn(); // TypeError: range.getLastColumn is not a function

【解決策】

getLastColumn() は Sheet(部屋)が持っている命令 です。

必ず sheet.getLastColumn() のように、個別のシートオブジェクトに対して呼び出す ことを意識しましょう!

6. まとめ&次回予告

今回は、表の横幅(最終列)を自動判定する Sheet.getLastColumn() を徹底解説しました。

今日の重要ポイント

  1. getLastColumn() はデータが入っている一番右端の「列番号(数値)」を取得する命令
  2. 結果は "E" などの文字ではなく、5 などの「数値」で返ってくる
  3. getLastRow() と組み合わせた sheet.getRange(1, 1, lastRow, lastColumn) は実務必須の黄金パターン
  4. 見た目は空欄でもスペースや数式が入っているとカウントされるので注意

これで、縦にも横にも自在に伸び縮みするスプレッドシートの表を、完璧にプログラムで捉えられるようになりましたね!

「表の範囲を掴む」ことができるようになったら、次にやりたいのは 「その表の中に入っている大量のデータを一括でプログラムの中に読み込むこと」 です!

次回(第13回)は、複数セルのデータを「2次元配列」として一気に取得する超重要メソッド Range.getValues() を解説します。これ覚えるとGASの処理速度が100倍アップしますよ!お楽しみに!