GetDisplayValues

Google Apps Script (GAS) を用いてスプレッドシートのデータを操作する際、複数セルの値（データ）を効率的かつ高速に取得することは、自動化スクリプトのパフォーマンスと信頼性を決定づける最も重要な要素の一つです。getValues()メソッドは、このニーズに応えるための基本的ながら極めて強力な機能です。

本記事では、GASのRange.getValues()メソッドを徹底解説します。複数セルのデータを二次元配列として一括取得する基本から、getValue()やgetDisplayValues()との明確な違い、各データ型（数値、文字列、日付、真偽値）の挙動、さらには大規模データ処理のためのパフォーマンス最適化（チャンク処理）、そしてよくある「ハマりどころ」と対策まで、具体的なコード例を交えて分かりやすく紹介します。

Google Apps Script (GAS) でスプレッドシートのデータを扱う際、日付や通貨などのフォーマットを維持したまま、しかも高速に値を取得したい場面は非常に多いです。そんな時に絶大な効果を発揮するのが getDisplayValues() メソッドです。

この記事では、getDisplayValues() を使って複数セルの表示値を一括で取得する方法に焦点を当て、その基本からパフォーマンスの重要性、実践的なデータ加工テクニックまでを詳しく解説します。

Google Apps Script 始め方 スプレッドシート 活用例 を各ショップで検索

楽天市場で探す Amazonで探す Yahoo!ショッピングで探す

getDisplayValues() とは？ - 見たままの値をまとめて取得

getDisplayValues() は、指定した範囲のセルに表示されている値（表示値）を、そのままのフォーマットで二次元配列として一括で取得するメソッドです。

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

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

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