日付と数値の形式を設定すると、シートでのデータの表示方法を制御できます。Google スプレッドシートには、一般的な形式がいくつか用意されていますが、独自の形式を定義することもできます。
スプレッドシートの UI で、[表示形式] > [数字] メニューを使用して、セルに数値と日付の形式を適用します。スプレッドシート API では、spreadsheets.batchUpdate メソッド呼び出しを使用してこれらの形式を設定し、UpdateCellsRequest または RepeatCellRequest を送信します。
このページでは、API リクエストに含めることができる新しい日付と数値の形式パターンを定義する方法について説明します。サンプル 範囲のカスタム日時形式または小数形式を設定するは、API を使用して形式パターンを設定する方法を示しています。形式の実際のレンダリングは、スプレッドシートの locale によって異なります。このガイドでは、locale が en_US であることを前提としています。スプレッドシートの locale は、spreadsheets.get リクエストで SpreadsheetProperties を読み取ることで確認できます。
日付と時刻の値について
他のほとんどのスプレッドシート アプリケーションと同様に、Google スプレッドシートでは日付と時刻の値が小数値として扱われます。これにより、数式で算術演算を実行できるため、日や週の増分、2 つの日付と時刻の加算や減算などの操作を行うことができます。
スプレッドシートでは、一般的に使用されている エポック日付の形式が使用されます。値の整数部分（小数点の左側）は、1899 年 12 月 30 日からの日数をカウントします。小数部（小数点の右側）は、1 日の分数として時間をカウントします。たとえば、1900 年 1 月 1 日の正午は 2.5、2 になります。これは、1899 年 12 月 30 日から 2 日後であり、正午は半日であるため 0.5 になります。1900 年 2 月 1 日午後 3 時は 33.625 です。
スプレッドシートでは、1900 年はうるう年ではなく平年として正しく処理されます。
日付と時刻の形式パターン
日時形式パターンは、解析時に対応する日時要素（月や時間など）に置き換えられるトークン サブストリングの文字列です。
日付と時刻の形式トークン
次の表に、日時形式パターンで使用できるトークン サブストリングの定義を示します。+ 文字は、直前の文字が 1 回以上出現してもパターンに一致することを示します。下の表に記載されていない文字はリテラルとして扱われ、変更されずに出力されます。
| トークン | 説明 |
|---|---|
h | 時間帯。文字列に AM または PM のインジケーターが含まれているかどうかに応じて、12 時間形式と 24 時間形式を切り替えます。 |
hh+ | 前項と同じですが、1 ～ 9 の場合は先頭に 0 が付きます。 |
m | 前の非リテラル トークンが時間で、次のトークンが秒の場合、1 時間の分数を表します（先頭の 0 は付きません）。それ以外の場合は、年内の月を数値で表します（先頭に 0 は付きません）。 |
M | 先頭に 0 を付けない月。このトークンを使用すると、パターンで分ではなく月を明示的に指定できます。 |
mm | m と同じですが、どちらの場合も先頭に 0 が付きます。 |
MM | 先頭に 0 が付いた月。このトークンを使用すると、パターンで分ではなく月を明示的に指定できます。 |
mmm | 月の 3 文字の省略表記（例: 「Feb」）。 |
mmmm | 完全な月の名前。mmmmmm+ もこれに一致します。 |
mmmmm | 月の最初の文字（6 月の場合は「J」など）。 |
s | 分内の秒（先頭の 0 はなし）。 |
ss | 分内の秒（先頭に 0 が付く）。 |
[h+] | 時間内の経過時間数。文字数は最小桁数を示します（先頭に 0 を追加します）。 |
[m+] | 時間内の経過時間（分単位）。文字数は最小桁数を示します（先頭に 0 を追加します）。 |
[s+] | 期間の経過秒数。文字数は最小桁数を示します（先頭に 0 を追加します）。 |
d | 月内の日付。10 未満の数字の場合、先頭に 0 は付けません。 |
dd | 月内の日付。10 未満の数字の場合は先頭に 0 が付きます。 |
ddd | 曜日の 3 文字の省略形（例: 「Mon」）。 |
dddd+ | 曜日のフルネーム。 |
y | 2 桁の年。 |
yy | |
yyy | 4 桁の年。 |
yyyy+ | |
a/p | 午前は「a」、午後は「p」を表示します。また、時刻を 12 時間形式に変更します。トークン文字が大文字の場合、出力も大文字になります。 |
am/pm | 上記と同様ですが、「AM」または「PM」が表示され、常に大文字で表示されます。 |
0 | 10 分の 1 秒単位。00 を使用すると精度を 2 桁に、000 を使用すると精度を 3 桁（ミリ秒）に上げることができます。 |
\ | 次の文字をリテラル値として扱い、特別な意味は持ちません。 |
"text" | 引用符で囲まれたテキストをリテラルとして表示します。 |
日付と時刻の形式の例
次の表は、日付と時刻 Tuesday, April 5, 2016, 4:08:53.528 PM を指定した場合の、パターン例とそれに対応する日時表示を示しています。表の 2 番目のセクションには、経過時間が 3 hours, 13 minutes, 41.255 seconds の場合の経過時間の形式の例を示します。
| 日時パターン | Tuesday, April 5, 2016, 4:08:53.528 PM |
|---|---|
h:mm:ss.00 a/p | 4:08:53.53 p |
hh:mm A/P".M." | 午後 4 時 8 分 |
yyyy-mm-dd | 2016-04-05 |
mmmm d \[dddd\] | 4 月 5 日 [火曜日] |
h PM, ddd mmm dd | 4 月 5 日（火）午後 4 時 |
dddd, m/d/yy at h:mm | 2016 年 4 月 5 日（火）16 時 8 分 |
| 経過時間パターン | 3 hours, 13 minutes, 41.255 seconds |
[hh]:[mm]:[ss].000 | 03:13:41.255 |
[mmmm]:[ss].000 | 0193:41.255 |
数値形式パターン
数値形式パターンは、解析時に対応する数値表現に置き換えられるトークン サブストリングの文字列です。数値形式のパターンは、セミコロンで区切られた最大 4 つのセクションで構成できます。これらのセクションでは、正の数、負の数、ゼロ、テキストに使用される個別の形式を定義します（この順序で）。
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]
形式に 4 つのセクションすべてを含める必要はありません。セクションを 1 つだけ含める場合は、その形式がすべての値に使用されます。2 つのセクションを使用すると、1 つ目の形式が 0 と正の数値に適用され、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 つとして含めることができます（ただし、これはあまり役に立ちません）。
数値形式トークン
次の表では、形式セクションで使用して、そのセクションの値を表す方法を定義できるトークン サブストリングを定義します。
| トークン | 説明 |
|---|---|
0 | 数値内の 1 桁を表します。桁が有効でない 0 の場合、0 としてレンダリングされます。たとえば、数値形式 00.0 では、数値 3 は「03.0」と表示されます。 |
# | 数値内の 1 桁を表します。数字が有効でない 0 の場合、レンダリングされません。たとえば、数値形式 ##0 では、数値 12 は「12」と表示されます。 |
? | 数値内の 1 桁を表します。数字が無効な 0 の場合、空白としてレンダリングされます。これは、固定幅フォントを使用する場合に、列の小数点位置を揃えるために使用されることがよくあります。たとえば、数値形式 ???.??? は、数値 12.4 を「 12.4 」としてレンダリングします。 |
. | 最初のピリオドは数値の小数点を示します。後続のピリオドはリテラルとしてレンダリングされます。形式に小数点が含まれている場合は、整数であっても常にレンダリングされます。たとえば、#0.# は数値 3 を「3.」としてレンダリングします。 |
% | リテラルとして表示されますが、既存の数値を 100 倍してからレンダリングして、パーセンテージを読みやすくします。たとえば、数値形式 #% では、数値 0.25 は「25%」と表示されます。 |
, | 2 桁の文字（0、#、?）の間に表示される場合は、グループ区切り文字（千単位でグループ化）を使用して数値全体をレンダリングします。数字文字の後に続く場合は、カンマごとに数字を 1,000 倍します（たとえば、#0.0,, 形式では、12,200,000 という数字が 12.2 としてレンダリングされます）。 |
E- | 数値を科学的記数法でレンダリングします。E の左側の書式は指数以外の部分に使用され、E の右側の書式は指数の部分に使用されます。E+ は、正の指数に対して + 記号を表示します。E- は、負の指数に対してのみ符号を表示します。小文字が使用されている場合、出力 e も小文字になります。たとえば、数値形式 ##0.00#E+## では、数値 0.0000001 は「100.00E-9」と表示されます。 |
E+ | |
e- | |
e+ | |
/ | 2 桁の文字（0、#、?）の間に現れた場合、それらの数字のグループは分数形式として扱われます。たとえば、数値形式 0 #/# では、数値 23.25 は 23 1/4 としてレンダリングされます。分母はリテラル整数にすることもできます。この場合、その整数が分母として強制されます。数値形式 0 #/8 では、数値 23.25 は 23 2/8 と表示されます。分子が 0 になると、分数部分はレンダリングされません。数値形式 0 #/3 の数値 23.1 は、23 としてレンダリングされます（0.1 は 0/3 に丸められるため）。/ は、科学的書式や小数点を含む書式と互換性がありません。 |
* | これは、Microsoft Excel の数値形式との互換性を確保するために含まれています。現在、この値は無視されます。 |
_ | アンダースコア トークンは次の文字をスキップし、スペースをレンダリングします。これは、負の値がかっこで囲まれている数値形式を揃えるために使用されます。 |
\ | 次の文字をリテラル値として扱い、特別な意味は持ちません。たとえば、数値形式 \#0 では、数値 10 は「#10」と表示されます。 |
"text" | 引用符で囲まれたテキストをリテラルとして表示します。 |
@ | セルにテキスト入力がある場合は、セルの生のテキストを挿入します。他の特殊文字との互換性はありません。数値（一般形式で表示）には表示されません。 |
$ - + ( ) : space | スプレッドシートでは、これらの文字はリテラルとして扱われ、変更されずに表示されます。 |
メタ指示
また、各形式セクションには、形式の前に [] 文字で囲まれたオプションのメタ命令を含めることができます。このメタ命令は、追加の指示を提供します。メタ命令には 2 種類あり、特定のセクションでは両方を使用できます。
| 手順 | 説明 |
|---|---|
[condition] | セクションのデフォルトの正、負、ゼロの比較を別の条件式に置き換えます。たとえば、[<100]”Low”;[>1000]”High”;000 は、値が 100 未満の場合は「Low」、1,000 を超える場合は「High」、その間の値の場合は 3 桁の数字（先頭に 0 が付く）をレンダリングします。条件は最初の 2 つのサブフォーマットにのみ適用できます。数値が複数のサブフォーマットに一致する場合は、最初に一致したサブフォーマットが使用されます。3 つ目の形式がある場合は、「その他すべて」に使用されます。それ以外の場合、数値がどちらの形式にも一致しない場合は、セル幅いっぱいに「#」が並んだ形式でレンダリングされます。存在する場合は、テキストに常に 4 番目の形式が使用されます。 |
[Color] or [Color#] | このサブフォーマットでレンダリングされる値が、指定されたテキストの色で表示されます。Color の有効な値は、Black、Blue、Cyan、Green、Magenta、Red、White、Yellow です。Color# の「#」に指定できる値は 1 ～ 56 です（このカラーパレットに、各番号に対応する色のリストが示されています）。数値形式の色は、セルに入力された色をオーバーライドしますが、条件付き書式で設定された色はオーバーライドしません。 |
数値形式の例
次の表に、パターンの例と、対応する書式設定された数値のレンダリングを示します。
| 数値 | パターン | 書式設定された値 |
|---|---|---|
| 12345.125 | ####.# | 12345.1 |
| 12.34 | 000.0000 | 012.3400 |
| 12 | #.0# | 12.0 |
| 5.125 | # ???/??? | 5 1/8 |
| 12000 | #,### | 12,000 |
| 1230000 | 0.0,,"M" | 120 万 |
| 1234500000 | 0.00e+00 | 1.23e+09 |
| 123114.15115 MyText | ###0.000;"TEXT: "_(@_) | 123114.151 TEXT: MyText |
| 1234 -1234 0 MyText | [Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_) | 1,234 1,234 0.0 MyText |
| 1005 32 527 | [>1000]"HIGH";[Color43][<=200]"LOW";0000 | HIGH LOW 0527 |