【GASスプレッドシート】getNextDataCell()でデータ終端を効率的に取得・SEO最適化

/**
 * A1セルから下方向へデータが連続する最終セルを見つける関数。
 * ExcelのCtrl + ↓ キー操作に相当します。
 */
function findEndOfData() {
  const sheet = SpreadsheetApp.getActiveSheet(); // アクティブなシートを取得
  const startCell = sheet.getRange('A1');      // 探索開始セルをA1に設定
  
  // A1セルから下方向のデータの終端を探す
  const direction = SpreadsheetApp.Direction.DOWN;
  const edgeCell = startCell.getNextDataCell(direction);
  
  // 取得した最終セルのA1表記（例: "A15"）をログに出力
  console.log(`A1から下方向のデータ終端: ${edgeCell.getA1Notation()}`);
}

/**
 * A列のデータが入力されている最終行番号を取得する関数。
 */
function getColumnLastRow() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const startCell = sheet.getRange('A1'); // A列の先頭セルを基準とする
  
  // A1から下方向のデータの終端セルを取得
  const bottomCell = startCell.getNextDataCell(SpreadsheetApp.Direction.DOWN);
  
  // 取得した最終セルの行番号をログに出力
  console.log(`A列のデータ最終行: ${bottomCell.getRow()}`);
}

/**
 * 1行目のデータが入力されている最終列番号を取得する関数。
 */
function getRowLastColumn() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const startCell = sheet.getRange('A1'); // 1行目の先頭セルを基準とする
  
  // A1から右方向のデータの終端セルを取得
  const rightCell = startCell.getNextDataCell(SpreadsheetApp.Direction.NEXT);
  
  // 取得した最終セルの列番号をログに出力
  console.log(`1行目のデータ最終列: ${rightCell.getColumn()}`);
}

/**
 * シート内の全てのデータブロック（空白行で区切られた範囲）を検出する関数。
 */
function findAllDataBlocks() {
  const sheet = SpreadsheetApp.getActiveSheet();
  let currentCell = sheet.getRange('A1'); // 探索を開始する初期セル
  let blockCount = 0;

  // currentCellが空白でなくなるまでループ (データブロックが存在する限り)
  while (currentCell.getValue() !== "") {
    blockCount++;
    const blockStart = currentCell; // 現在のセルがブロックの開始点
    // 現在のブロックの終端セルを下方向に探索
    const blockEnd = blockStart.getNextDataCell(SpreadsheetApp.Direction.DOWN);
    
    console.log(`データブロック ${blockCount}: ${blockStart.getA1Notation()} から ${blockEnd.getA1Notation()}`);
    
    // 次のブロックの開始セルに移動 (現在のブロック終端の1行下)
    currentCell = blockEnd.offset(1, 0); // offset(行数, 列数) で相対的に移動
  }
  if (blockCount === 0) {
    console.log("シートにデータブロックが見つかりませんでした。");
  }
}

/**
 * シート内のデータ表全体の範囲を自動で特定する関数。
 * 開始セルから上下左右に探索し、最大のデータ範囲を割り出します。
 */
function findTableRange() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const startCell = sheet.getRange('A1'); // 表の左上端のセルを基準とする（データがあることが前提）
  
  // 各方向のデータ終端セルを取得
  const top    = startCell.getNextDataCell(SpreadsheetApp.Direction.UP);
  const bottom = startCell.getNextDataCell(SpreadsheetApp.Direction.DOWN);
  const left   = startCell.getNextDataCell(SpreadsheetApp.Direction.PREVIOUS);
  const right  = startCell.getNextDataCell(SpreadsheetApp.Direction.NEXT);
  
  // 検出した範囲から全体の表範囲をRangeオブジェクトとして取得
  const tableRange = sheet.getRange(
    top.getRow(),                           // 開始行
    left.getColumn(),                       // 開始列
    bottom.getRow() - top.getRow() + 1,     // 行数
    right.getColumn() - left.getColumn() + 1 // 列数
  );
  console.log(`検出した表の全体範囲: ${tableRange.getA1Notation()}`);
  
  return tableRange; // 取得したRangeオブジェクトを返す
}

/**
 * データが存在しない状況でも安全にgetNextDataCell()を使用するためのエラーハンドリング例。
 */
function safeGetNextDataCell() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const startCell = sheet.getRange('A1');
  
  try {
    const edgeCell = startCell.getNextDataCell(SpreadsheetApp.Direction.DOWN);
    console.log(`データの終端: ${edgeCell.getA1Notation()}`);
  } catch (e) {
    // データが見つからなかった場合に警告をログに出力し、スクリプトの停止を防ぐ
    console.warn(`下方向にデータが見つかりませんでした: ${e.message}`);
    // 必要に応じて、ここで代替処理やユーザーへの通知を行う
  }
}