【GASスプレッドシート】getNumberFormats()で複数セルの表示形式を一括取得・SEO最適化

/**
 * アクティブなシートのA1:C3範囲の全セルの表示形式を一括取得し、ログに出力する関数。
 */
function getAndLogAllNumberFormats() {
  const sheet = SpreadsheetApp.getActiveSheet(); // アクティブなシートを取得
  const range = sheet.getRange("A1:C3");      // 対象範囲をA1:C3に設定
  
  // 指定範囲の各セルの表示形式を二次元配列として一括取得
  const formats = range.getNumberFormats();
  
  // 取得した二次元配列の内容をJSON形式でログに出力 (視認性のため整形)
  Logger.log(`A1:C3範囲の表示形式:\n${JSON.stringify(formats, null, 2)}`);
  /*
   * 例: formats の出力形式
   * [
   *   ['#,##0', 'yyyy/MM/dd', '0.0%'],
   *   ['General', 'h:mm:ss', '"$"#,##0.00'],
   *   ['@', 'yyyy/MM/dd h:mm:ss', '#,##0.00E+00']
   * ]
   */
}

/**
 * 指定範囲の各セルの表示形式を読み取り、A1表記と共にログに出力する関数。
 */
function iterateAndLogNumberFormats() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('データシート'); // 対象シート名
  if (!sheet) {
    Logger.log("エラー: 指定されたシートが見つかりません。");
    return;
  }
  const range = sheet.getRange('A1:B3'); // 検査対象範囲
  const formats = range.getNumberFormats();
  
  // 取得した二次元配列 (formats[rowIndex][colIndex]) をループ処理
  formats.forEach((rowFormats, rowIndex) => {
    rowFormats.forEach((format, colIndex) => {
      // getCell(row, column) は1から始まるインデックス
      const cellAddress = range.getCell(rowIndex + 1, colIndex + 1).getA1Notation();
      Logger.log(`セル ${cellAddress} の表示形式: ${format}`);
      
      // 例: 日付フォーマットのセルを検出
      if (format.includes('yyyy') || format.includes('MM') || format.includes('dd')) {
        Logger.log(`  -> このセル (${cellAddress}) は日付形式の可能性があります。`);
      }
    });
  });
}

/**
 * 特定の列（C列、D列、E列）の表示形式を検証し、期待値と異なる場合は警告を出す関数。
 * 自動修正機能を追加することも可能です。
 */
function validateAndCorrectColumnFormats() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('売上データ');
  if (!sheet) {
    Logger.log("エラー: '売上データ' シートが見つかりません。");
    return;
  }
  
  // 列番号と期待されるフォーマットの定義 (GASの列は1から始まる)
  const formatRules = {
    3: 'yyyy/MM/dd',      // C列: 日付
    4: '#,##0',           // D列: 数量（整数）
    5: '"¥"#,##0'         // E列: 金額（円）
  };

  const startRow = 2;     // データ開始行 (ヘッダー行を除く)
  const lastRow = sheet.getLastRow();
  // 検証対象範囲を複数の列にまたがるように取得 (C列からE列まで)
  const rangeToValidate = sheet.getRange(startRow, 3, lastRow - startRow + 1, 3); // C列からE列
  const formats = rangeToValidate.getNumberFormats(); // 範囲の表示形式を一括取得

  formats.forEach((rowFormats, rowIndex) => {
    Object.keys(formatRules).forEach(colNumberStr => {
      const colNumber = parseInt(colNumberStr, 10); // 列番号を数値に変換
      const colIndexInArray = colNumber - 3; // 取得した配列内での列インデックス (0から始まる)
      
      const expectedFormat = formatRules[colNumber];
      const actualFormat = rowFormats[colIndexInArray];
      
      if (actualFormat !== expectedFormat) {
        const cellAddress = sheet.getRange(startRow + rowIndex, colNumber).getA1Notation();
        Logger.warn(`フォーマット不一致を検出: セル ${cellAddress} | 期待: "${expectedFormat}", 実際: "${actualFormat}"`);
        
        // ★ オプション: ここで setNumberFormat() を使って自動修正することも可能
        // sheet.getRange(cellAddress).setNumberFormat(expectedFormat);
        // Logger.log(`-> セル ${cellAddress} のフォーマットを修正しました。`);
      }
    });
  });
  Logger.log("表示形式の検証が完了しました。");
}