表示形式

Google Apps Script (GAS) を用いたスプレッドシートの自動化において、複数セルの表示形式（数値、日付、通貨、パーセンテージなど）を効率的に管理することは、データの正確性とスクリプトのパフォーマンス向上に不可欠です。個々のセルに対して表示形式を取得するgetNumberFormat()も便利ですが、広範囲のセルを扱う場合には非効率になります。

本記事では、スプレッドシートの指定範囲からセルの表示形式を二次元配列で一括取得できるgetNumberFormats()メソッドを徹底解説します。基本的な使い方から、getNumberFormat()との違い、さらにはデータ整合性チェックや自動修正といった実用的な応用例までを、具体的なコード例を交えて紹介します。

Google Apps Script (GAS) を利用してスプレッドシートを操作する際、データの正確性を保つ上でセルの表示形式（数値、日付、通貨など）の管理は非常に重要です。例えば、「この日付セルは正しいフォーマットか？」「数値は通貨形式になっているか？」といった検証作業は、データの整合性を維持するために欠かせません。

本記事では、GASで単一セルの表示形式を効率的に取得できるgetNumberFormat()メソッドの基本的な使い方から、複数セルの形式を一括で扱うgetNumberFormats()、さらには取得した情報に基づいて表示形式を自動でチェックし、修正する実践的な応用例までを徹底解説します。

スプレッドシート上の「¥1,200」や「2025/12/25」といった値をGASで取得したら、1200 というただの数値や、よく分からない長い日付オブジェクトになって困った経験はありませんか？

これは、GASがセルの「内部的な値」を読み込んでいるために起こる現象です。ユーザーが画面で見ている通りのフォーマットされた値を取得したいときに活躍するのが、getDisplayValue() メソッドです。

この記事では、getDisplayValue() の正しい使い方、getValue() との決定的な違い、そして業務で役立つ実践例を分かりやすく解説します。