Google Apps ScriptのgetNumberFormat()を使いこなすばい！

Google Apps Script（GAS）でスプレッドシートのデータを扱うとき、数値や日付の表示形式を取得したいことってあるばい？そんなとき役立つのがgetNumberFormat()メソッドたい。本記事では、その使い方から応用まで、しっかり解説するばい！

getNumberFormat()って何するもん？

getNumberFormat()は、セルに設定されとる表示形式を取得するメソッドじゃ。例えば、yyyy/MM/ddの形式になっとる日付や、通貨のフォーマットを取得できるとさ。

使い方はこればい！

const sheet = SpreadsheetApp.getActiveSheet();
const cell = sheet.getRange("A1");
const format = cell.getNumberFormat();
Logger.log(format); // 例: "yyyy/MM/dd"

範囲内のフォーマットを一括取得する方法

セルが1つならgetNumberFormat()を使うばってん、範囲を指定して複数セルのフォーマットを取得するには、getNumberFormats()を使うとよ。

const formats = sheet.getRange("A1:B2").getNumberFormats();
// [["#,##0.00", "0.00%"], ["yyyy/MM/dd", "$#,##0.00"]]

実践！数値フォーマットのチェック

たとえば、スプレッドシートのデータが正しいフォーマットになっとるかチェックする関数を作ってみるばい。

function checkDateFormat() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("SalesData");
  const dateCell = sheet.getRange("C5");
  const currentFormat = dateCell.getNumberFormat();
  
  if (currentFormat !== "yyyy-MM-dd") {
    dateCell.setNumberFormat("yyyy-MM-dd");
  }
}

フォーマットの種類とその意味

フォーマット文字列	表示例	適用データ型
“#,##0.00”	12,345.67	数値
“0.00%”	98.76%	パーセント
“yyyy-MM-dd”	2025-03-06	日付
“[$¥-411]#,##0.00”	¥12,345.67	通貨
“0.0E+00”	1.2E+03	指数表記