日付と数値の形式

日時と数値の形式を設定すると、シートに表示されるデータの表示方法を制御できます。Google スプレッドシートには、一般的な形式がいくつか用意されていますが、独自の形式を定義することもできます。

スプレッドシートの UI では、[表示形式] > [数値] メニューを使用して、セルに数値形式と日付形式を適用します。Sheets API では、spreadsheets.batchUpdate メソッド呼び出しを使用してこれらの形式を設定し、UpdateCellsRequest または RepeatCellRequest を送信します。

このページでは、API リクエストに含めることができる新しい日付と数値の形式パターンを定義する方法について説明します。サンプルの範囲にカスタムの日時形式または小数点形式を設定するでは、API を使用して形式パターンを設定する方法を示しています。形式の実際のレンダリングは、スプレッドシートの locale によって異なります。このガイドでは、locale が en_US であることを前提としています。スプレッドシートの locale は、spreadsheets.get リクエストで SpreadsheetProperties を読み取ることで確認できます。

日付と時刻の値について

他のほとんどのスプレッドシート アプリケーションと同様に、スプレッドシートでは日付と時刻の値は小数値として扱われます。これにより、数式で演算を実行できるため、日数や週数を増やす、2 つの日付と時刻を加算または減算する、その他の同様の操作を行うことができます。

スプレッドシートでは、スプレッドシートで一般的に使用されているエポック日付の形式が使用されます。値の整数部分（小数点の左側）は、1899 年 12 月 30 日からの日数をカウントします。小数部分（小数点の右側）は、時間を 1 日の小数としてカウントします。たとえば、1900 年 1 月 1 日の正午は 2.5 です。1899 年 12 月 30 日の 2 日後であるため 2 であり、正午は半日であるため 0.5 です。1900 年 2 月 1 日午後 3 時は 33.625 です。

1900 年がうるう年ではなく平年として正しく扱われるようになりました。

日付と時刻の形式のパターン

日時形式のパターンは、トークンのサブ文字列の文字列で、解析時に対応する日時要素（月や時刻など）に置き換えられます。

日付と時刻の形式トークン

次の表に、日時形式パターンで使用できるトークンのサブ文字列を示します。+ 文字は、直前の文字が 1 回以上出現してもパターンと一致することを示します。以下の表に記載されていない文字はリテラルとして扱われ、変更なしで出力されます。

日付と時刻の形式の例

日時 Tuesday, April 5, 2016, 4:08:53.528 PM の場合、次の表に示すパターンの例と、それぞれ日時の表示方法を示します。表の 2 番目のセクションに、経過時間 3 hours, 13 minutes, 41.255 seconds の形式の例を示します。

数値形式のパターン

数値形式パターンは、トークンのサブ文字列の文字列で、解析時に対応する数値表現に置き換えられます。数値形式のパターンは、セミコロンで区切られた 4 つまでのセクションで構成できます。これらのセクションは、正の数、負の数、ゼロ、テキストに使用される個別の形式を定義します（順序は上記のとおりです）。

[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]

4 つのセクションをすべてフォーマットに含める必要はありません。1 つのセクションのみを指定した場合、その形式がすべての値に使用されます。2 つのセクションを使用すると、最初の形式がゼロと正の数値に適用され、2 番目の形式が負の数値に適用されます。3 つのセクションを使用すると、正の数、負の数、ゼロの数に別々の形式を定義できます。次に例を示します。

[NUMBER FORMAT]
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT]
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]

ただし、セクションが 2 つ以上あり、最後のセクションがテキスト形式の場合、そのセクションはテキスト形式として扱われ、他のセクションはセクションが 1 つ少ない場合と同じように動作します。最終的なテキスト形式を含めることで、次のような形式を定義できます。

[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT]
[NUMBER FORMAT];[TEXT FORMAT]

形式のセクションへの解析は他の解析の前に行われるため、日付または時刻の形式をセクションの 1 つとして含めることができます（ただし、有用性は限られます）。

数値形式トークン

次の表に、形式セクションで使用して、そのセクションの値の表示方法を定義できるトークンのサブ文字列を示します。

メタに関する手順

さらに、各形式セクションには、形式の前に追加の手順を指定するオプションのメタ インストラクション（[] 文字で囲む）を含めることができます。メタ命令には 2 つのタイプがあり、特定のセクションでは両方を使用できます。

数値形式の例

次の表に、パターンの例と、それぞれフォーマットされた数値の表示を示します。