【GAS】getFormulaとgetFormulasの違いとは？セルの数式を正しく取得する方法

// A1に"=SUM(C1:C2)"、B1に"=SUM(D1:D2)"が入っているとする
const range = SpreadsheetApp.getActiveSheet().getRange("A1:B1");
// A1の数式しか返ってこない
const formula = range.getFormula(); 
console.log(formula); // "=SUM(C1:C2)"

function fetchAllFormulas() {
  const range = SpreadsheetApp.getActiveSheet().getRange("A1:B2");
  const formulas = range.getFormulas();
  
  // 例: [["=SUM(C1:C2)", "=SUM(D1:D2)"], ["", "=A1*1.1"]]
  console.log(formulas); 
}

function backupAllFormulas() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sourceSheet = ss.getActiveSheet();
  const sourceRange = sourceSheet.getDataRange();
  
  // 範囲の数式を一括取得
  const formulas = sourceRange.getFormulas();

  let backupSheet = ss.getSheetByName(sourceSheet.getName() + '_数式バックアップ');
  if (!backupSheet) {
    backupSheet = ss.insertSheet(sourceSheet.getName() + '_数式バックアップ');
  }
  backupSheet.clear();
  
  // 取得した数式をバックアップシートに一括設定
  backupSheet.getRange(1, 1, formulas.length, formulas[0].length).setFormulas(formulas);
  
  SpreadsheetApp.getUi().alert('数式のバックアップが完了しました。');
}

function findCellsWithSpecificFunction() {
  const FUNCTION_NAME = "VLOOKUP";
  
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getDataRange();
  const formulas = range.getFormulas();
  
  const foundCells = [];

  formulas.forEach((row, r) => {
    row.forEach((formula, c) => {
      // toUpperCase()で大文字小文字を区別しないようにする
      if (formula.toUpperCase().includes(FUNCTION_NAME)) {
        foundCells.push(range.getCell(r + 1, c + 1).getA1Notation());
      }
    });
  });
  
  if (foundCells.length > 0) {
    console.log(`${FUNCTION_NAME}関数が使われているセル: ${foundCells.join(', ')}`);
  } else {
    console.log(`${FUNCTION_NAME}関数が使われているセルは見つかりませんでした。`);
  }
}