Google Apps Script(GAS)で「データが入っている最後の行」を知りたい場面は多いです。新しい行を追記したい、範囲をまとめて読みたい、といった処理の起点になります。ところが、シート全体の最終行と、特定の列の最終行は別物で、取り方を間違えると空行だらけの範囲を読んだり、追記位置がずれたりします。
公式リファレンスでは、Sheet.getLastRow() は「内容のある最後の行の位置を返す」とされています。最終列は getLastColumn() です。
function sample1() {
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('データ');
const lastRow = sheet.getLastRow(); // 内容のある最終行
const lastCol = sheet.getLastColumn(); // 内容のある最終列
Logger.log('最終行: %s / 最終列: %s', lastRow, lastCol);
}
getDataRange() は、A1から最終行・最終列までの範囲(Range)を返します。読み取りはセルごとに getValue() を繰り返すのではなく、getValues() で二次元配列として一括で取るのが公式のベストプラクティスです(処理が速く、実行時間の節約にもなります)。
function sample2() {
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('データ');
const values = sheet.getDataRange().getValues(); // 二次元配列で一括取得
values.forEach(function (row) {
Logger.log(row.join(','));
});
}
getLastRow() はシート全体の最終行です。「A列だけの最終行」が欲しい場合は、その列の値を配列で取り、下から探します。途中に空白セルがある表では、単純に「値の個数を数える」方法だとずれるため、下からの走査が確実です。
function lastRowOfColumn(sheet, col) {
const values = sheet.getRange(1, col, sheet.getLastRow(), 1).getValues();
for (let i = values.length - 1; i >= 0; i--) {
if (values[i][0] !== '') return i + 1;
}
return 0; // 列にデータなし
}
「最終行の次に1行足したい」だけなら、自分で最終行を計算するより appendRow() を使うほうが安全です。データ範囲の直後に行を追加してくれます。
function sample4() {
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('データ');
sheet.appendRow(['2026-11-21', '山田商店', 12000]);
}
getLastRow() は「シート内のどこかに内容がある最終行」です。表と離れた場所にメモ書きなどがあると、その行までが最終行になります。想定より大きな値が返る場合は、シート下部に余計な入力がないか確認してください。appendRow() を優先するのが経験上も無難です。参照:Google Apps Script 公式リファレンス(Class Sheet:getLastRow / getDataRange / appendRow)、公式ベストプラクティス。
「毎週の転記・集計をなくしたい」「CSVの整形を自動化したい」「古いGASを直したい」といったご相談を承っています。1ファイル・1処理の小さな作業から対応し、作業前に必ずメッセージで内容を確認して、対応範囲と金額を先にお伝えします。検証記録と手順書付きで納品します。
相談してみる(Coconala)※出品ページは準備中です。公開まではこのボタンは仮のリンクです。