6.3 APIで利用できるデータ型
APIで利用できるデータ型を次の表に示します。
|
データ型 |
説明 |
|---|---|
|
boolean |
trueまたはfalse |
|
int |
32bit符号付き整数 |
|
long |
64bit符号付き整数 |
|
string※ |
テキストデータ |
- 注※
-
JSON形式でダブルクォーテーションやバックスラッシュなどの文字を使用する場合は，次の表に示すようにエスケープする必要があります。
|
文字 |
エスケープ表記 |
|---|---|
|
「"（ダブルクォーテーションマーク）」 |
\" |
|
「¥（バックスラッシュ）」 |
\\ |
|
バックスペース |
\b |
|
フォームフィード，改ページ |
\f |
|
ラインフィード |
\n |
|
キャリッジリターン |
\r |
|
タブ |
\t |
|
4桁の16進数で表記されたUnicode文字 |
\uXXXX |
日付と時間は，ISO8601形式で指定または返却される場合，次の形式で示されます。
- 形式
YYYY-MM-DDThh:mm:ssTZD
|
表記 |
説明 |
指定できる値 |
|---|---|---|
|
YYYY |
年を指定します。 |
1994〜2036 |
|
MM |
月を指定します。 |
01〜12 |
|
DD |
日にちを指定します。 |
01〜指定した月の最終日 |
|
hh |
時間を指定します。 |
00〜23 |
|
mm |
分を指定します。 |
00〜59 |
|
ss |
秒を指定します。 |
00〜59 |
|
TZD |
マネージャーホストの時刻と協定世界時（UTC）との時差を指定します。UTCの場合は「Z」を指定します。UTC以外の場合は「+hh:mm」または「-hh:mm」の形式で指定します。 |
Z，+hh:mm，-hh:mm |
例えば，協定世界時（UTC）が2015年1月16日午前0時0分0秒のとき，マネージャーホストが日本標準時で動作している場合，UTCとは+9時間の時差があるため，「2015-01-16T09:00:00+09:00」となります。マネージャーホストが中国標準時で動作している場合，UTCとは+8時間の時差があるため，「2015-01-16T08:00:00+08:00」となります。マネージャーホストがアメリカ東部標準時で動作している場合，UTCとは-5時間の時差があるため，「2015-01-15T19:00:00-05:00」となります。
また，夏時間を採用している国や地域の場合，夏時間を考慮して指定します。例えば，協定世界時（UTC）が2015年4月16日午前0時0分0秒のときに，マネージャーホストがアメリカ東部標準時（夏時間）で動作している場合，UTCとは-4時間の時差があるため，「2015-04-15T20:00:00-04:00」となります。