日時形式と数値形式を使用すると、シートにデータを出力する方法を制御できます。Google スプレッドシートでは、いくつかの一般的な書式から選択できますが、独自の書式を定義することもできます。
Google スプレッドシートの UI では、[表示形式] > [数値] メニューを使用して、数値と日付の形式をセルに適用します。Sheets API では、spreadsheets.batchUpdate
メソッド呼び出しを使用してこれらの形式を設定し、UpdateCellsRequest
または RepeatCellRequest
を送信します。
このページでは、API リクエストに含めることができる新しい日付と数値の形式のパターンを定義する方法について説明します。範囲にカスタムの日時または小数点の形式を設定するのサンプルでは、API を使用して形式パターンを設定する方法を示します。形式の実際のレンダリングは、スプレッドシートの locale
によって異なります。このガイドでは、locale
が en_US
であることを前提としています。スプレッドシートの locale
は、spreadsheets.get
リクエストを使用して SpreadsheetProperties
を読み取ることで確認できます。
日付と時刻の値について
他のほとんどのスプレッドシート アプリケーションと同様に、スプレッドシートは日付と時刻の値を 10 進数値として扱います。これにより、数式で計算を実行できるため、日付や週の増分、2 つの日付と時刻の加算や減算、その他の同様の処理が可能になります。
スプレッドシートでは、スプレッドシートで一般的に使用されているエポック日付の形式を使用します。値の整数部分(小数点の左側)は、1899 年 12 月 30 日からの日数をカウントします。小数部分(小数点の右側)は、時刻を 1 日の小数点以下としてカウントします。たとえば、1900 年 1 月 1 日正午は 2.5
、1899 年 12 月 30 日から 2 日後なので 2
、正午は半日なので 0.5
となります。1900 年 2 月 1 日午後 3 時は 33.625
です。
Google スプレッドシートでは、1900 年がうるう年ではなく通常の年として正しく扱われます。
日付と時刻の形式パターン
日時形式パターンはトークンの部分文字列の文字列で、解析時に対応する日時要素(月や時間など)に置き換えられます。
日付と時刻の形式トークン
次の表に、日時形式パターンで使用できるトークンの部分文字列を示します。+
文字は、直前の文字が 1 回以上出現し、引き続きパターンに一致することを示します。以下の表に示されていない文字はリテラルとして扱われ、変更なしで出力されます。
トークン | 説明 |
---|---|
h |
時間帯です。文字列に AM インジケーターまたは PM インジケーターが存在するかどうかに応じて、12 時間形式と 24 時間形式を切り替えます。 |
hh+ |
前と同じですが、1 ~ 9 の前に 0 が付きます。 |
m |
前の非リテラル トークンが時間であった場合、または後続のトークンが秒の場合は、時間内の分を表します(先頭に 0 は付けません)。それ以外の場合は、月を数値(先頭に 0 を付けない)で表します。 |
M |
月(先頭に 0 を付けない)。このトークンを使用して、パターンで 1 分ではなく 1 か月を明示的に記述します。 |
mm |
m と同じですが、どちらの場合も先頭に 0 が付きます。 |
MM |
先頭に 0 が付いた月。このトークンを使用して、パターンで 1 分ではなく 1 か月を明示的に記述します。 |
mmm |
月の 3 文字の略語(例: 「2 月」)。 |
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 |
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:08 |
経過時間のパターン | 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]
1 つのフォーマットに 4 つのセクションをすべて含める必要はありません。セクションが 1 つだけの場合は、その形式がすべての値で使用されます。2 つのセクションを使用すると、最初の書式がゼロと正の数に適用され、2 番目の書式が負の数に適用されます。セクションを 3 つ使用すると、正、負、ゼロのそれぞれの形式が定義されます。次に例を示します。
[NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]
ただし、複数のセクションがあり、最後のセクションがテキスト形式の場合、そのセクションはテキスト形式として扱われ、他のセクションは 1 つ少ないセクションとして扱われます。したがって、最終的なテキスト形式を含めることで、次のような形式を定義できます。
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT] [NUMBER FORMAT];[TEXT FORMAT]
形式のセクションへの解析は他の解析の前に行われるので、セクションの 1 つとして日付形式または時刻形式を含めることができます(ただし、有用性は限定的です)。
数値形式トークン
次の表は、そのセクションの値の表現方法を定義するために形式セクションで使用できるトークンの部分文字列を定義しています。
トークン | 説明 |
---|---|
0 |
数値の数字を表します。桁が意味のない 0 の場合は、0 としてレンダリングされます。たとえば、数値形式 00.0 は、数値 3 を「03.0 」としてレンダリングします。 |
# |
数値の数字を表します。桁が意味のない 0 の場合、レンダリングされません。たとえば、数値形式 ##0 は、数値 12 を「12 」としてレンダリングします。 |
? |
数値の数字を表します。桁が意味のない 0 の場合は、スペースとしてレンダリングされます。これは、固定幅フォントを使用する際に列内の小数点を揃えるために使用されます。たとえば、数値形式 ???.??? は、数値 12.4 を " 12.4 " としてレンダリングします。 |
. |
最初のピリオドは、数値の小数点を表します。それ以降のピリオドはリテラルとしてレンダリングされます。表示形式に小数点を含めると、整数の場合でも小数が常にレンダリングされます。たとえば、#0.# は数字 3 を「3. 」としてレンダリングします。 |
% |
リテラルとして表示されますが、パーセンテージを読みやすくするため、レンダリング前に既存の数値に 100 を掛けます。たとえば、数値形式 #% は、数値 0.25 を「25% 」としてレンダリングします。 |
, |
2 桁の文字(0 、# 、? )の間にある場合は、桁区切り記号(3 桁ごとのグループ化)で数字全体がレンダリングされます。数字が後に続く場合、カンマごとに 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 |
スプレッドシートではこれらの文字がリテラルとして扱われ、変更されずに表示されます。 |
Meta の手順
さらに、各形式のセクションには、形式の前に追加の指示を提供するオプションのメタ指示を []
文字で囲むことができます。メタ指示タイプは 2 つあり、1 つのセクションで両方を使用できます。
手順 | 説明 |
---|---|
[condition] |
セクションのデフォルトの正、負、またはゼロの比較を別の条件式に置き換えます。たとえば、[<100]”Low”;[>1000]”High”;000 は、100 未満の値には「Low」、1,000 を超える値には「High」、その中間には 3 桁の数字(先頭に 0 付き)をレンダリングします。条件は最初の 2 つのサブ形式にのみ適用でき、数値が複数の形式と一致する場合は、最初に一致した形式が使用されます。3 つ目の書式がある場合は、「その他すべて」に使用されます。それ以外の数値がいずれの書式とも一致しない場合は、すべての「#」でセル幅を埋めるようにレンダリングされます。4 つ目の形式が存在する場合は、その形式が常にテキストに使用されます。 |
[Color] or [Color#] |
このサブフォーマットがレンダリングする値を、指定されたテキストの色で表示します。Color の有効な値は、黒、青、シアン、緑、マゼンタ、赤、白、黄です。Color# の「#」の有効な値は 0 ~ 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 テキスト: MyText |
1234 -1234 0 MyText |
[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_) |
1,234 1,234 0.0 MyText |
1,005 32 527 |
[>1000]"HIGH";[Color43][<=200]"LOW";0000 |
高 低 0527 |