データ型

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

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

Google Apps Script (GAS) を用いてスプレッドシートを操作する際、**「セルの値を取得する」**ことは最も基本的な操作の一つです。getValue()メソッドは、この目的のために広く使われますが、その特性や注意点を理解せずに使用すると、予期せぬエラーやパフォーマンスの問題を引き起こす可能性があります。

本記事では、GASのRange.getValue()メソッドを徹底解説します。単一セルの値取得の基本から、複数セルの値を効率的に一括取得できるgetValues()との違い、各データ型（数値、文字列、日付、真偽値）の挙動、さらにはパフォーマンスを意識したベストプラクティスや堅牢なスクリプトのためのエラーハンドリングまで、具体的なコード例を交えて分かりやすく紹介します。