GASでスプレッドシートを
高速検索・一括置換する方法

function findAllMatches() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("顧客リスト");

  // シート全体から「未対応」を含むセルをすべて取得
  const finder = sheet.createTextFinder("未対応");
  const ranges = finder.findAll(); // Rangeの配列が返る

  Logger.log("一致件数: " + ranges.length);

  ranges.forEach((range) => {
    // A1形式の位置と値をログに出す
    Logger.log(range.getA1Notation() + " → " + range.getValue());
  });
}

function jumpToFirstMatch() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("顧客リスト");
  const finder = sheet.createTextFinder("要確認");

  // findNext() は次の一致セル（Range）を返す。無ければ null
  const first = finder.findNext();

  if (first) {
    first.activate(); // そのセルを選択状態にする
    Logger.log("最初の一致: " + first.getA1Notation());
  } else {
    Logger.log("一致するセルはありません");
  }
}

function findWithOptions() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("在庫");

  const ranges = sheet
    .createTextFinder("NG")
    .matchCase(true)        // 大文字・小文字を区別（ng とは一致しない）
    .matchEntireCell(true)  // セル全体が "NG" のときだけ一致（"NG品" は除外）
    .findAll();

  Logger.log("完全一致した件数: " + ranges.length);
}

function replaceStatus() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("案件管理");

  // 対象範囲を D列（ステータス列）に限定して一括置換
  const count = sheet
    .getRange("D2:D1000")
    .createTextFinder("進行中")
    .matchEntireCell(true)
    .replaceAllWith("対応中");

  Logger.log(count + " 件を『対応中』に置換しました");
}

function normalizePhone() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("顧客リスト");

  // 全角ハイフン・波ダッシュなどを半角ハイフンに統一
  const count = sheet
    .getRange("E2:E1000") // 電話番号列
    .createTextFinder("[‐－―ー~〜]") // 紛らわしいハイフン類をまとめて指定
    .useRegularExpression(true)
    .replaceAllWith("-");

  Logger.log(count + " 箇所のハイフンを半角に統一しました");
}

function highlightMatches() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("問い合わせ");
  const finder = sheet.getRange("B2:B2000").createTextFinder("至急");

  let range = finder.findNext();
  let count = 0;

  // findNext() を繰り返すと一致セルを順番に取得できる
  while (range !== null) {
    range.setBackground("#fff3b0"); // 黄色でマーキング
    count++;
    range = finder.findNext();
  }

  Logger.log(count + " 件の『至急』をハイライトしました");
}