Home » Googleスプレッドシートの使い方 » Google Apps Scriptで数値の表示形式を設定・取得する

Google Apps Scriptで数値の表示形式を設定・取得する

対象：Googleスプレッドシート & Google Apps Script

「google apps script セル書式設定」
という検索で、このサイト・インストラクターのネタ帳へのアクセスが時折あることに気付きました。

Googleスプレッッドシートの、セルの書式設定を行うGAS（Google Apps Script）のコードを探している方による検索でしょうか。

「セル書式」というキーワードが使われていますが、Googleスプレッッドシートの場合はメニュー［表示形式］から、セルの見た目をいろいろと設定することができます。

Google Apps Scriptで数字の表示形式を設定・取得する

「google apps script セル書式設定」
という検索をした方は、この中のどれかを設定したかったのでしょうか。

［スポンサードリンク］

「セル書式」というキーワードからは、
　　数字（の表示形式）
　　フォント（の種別）
　　フォントサイズ
　　太字・斜線・下線・取り消し線（が設定されているかどうか）
　　（セル内での文字の）配置
　　テキストの折り返し
あたりを設定したかったのでしょうか。

Excelのセルの書式設定と同じようなものをイメージしていたと仮定すると、
　　セルの塗りつぶしの色
　　枠線（罫線）の種類や色
あたりを設定したかったのかもしれません。

数値の表示形式を設定するサンプルスクリプト

どれを設定したかったのかはわかりませんが、表計算ソフトを使う上でもっとも重要度の高い、数字の表示形式を設定するGASスクリプトをここではご紹介しておきます。

function sample_set_number_format(){

　var bk = SpreadsheetApp.getActiveSpreadsheet();
　var sh = bk.getActiveSheet();
　var rng = sh.getActiveCell();

　rng.setNumberFormat("#,##0; [Red]-#,###");

}

上記のスクリプトを実行すると、アクティブなセルに
「#,##0; [Red]-#,###」
という表示形式が設定されます。「0」以上の数値は3桁区切りカンマ付きで表示し（#,##0）、負・マイナスの数値の場合には3桁区切りカンマをつけるほかに文字色を赤色にして数値の先頭に「-」（ハイフン）を付けて表示（[Red]-#,###）します。

GASからは、Range.setNumberFormatメソッドの引数に、どう表示したいのかを指定することで、数値の表示形式を設定できるわけです。