この記事では、商品データを登録する場合の日付と時刻の形式について説明します。日付と時刻は、入荷予定日 [availability_date]、セール価格有効期間 [sale_price_effective_date]、有効期限 [expiration_date] などの属性で登録します。
このページの内容
仕組み
この記事で詳しく説明する ISO 8601 標準を使用します。属性によっては、日付または日付範囲を登録し、特定の時刻を指定することができます。
日付の形式
次の形式で日付を指定します。
YYYY-MM-DD
たとえば、2017 年 5 月 11 日を登録するには、次の形式を使用します。
2017-05-11
時刻の指定
日付に特定の時刻を追加するには:
- 日付の後に
Tという文字を続けます。 - 24 時間形式（
hh:mm:ss）で時刻を追加します。例:13:00:14 - 時刻の後にタイムゾーンを追加します。例: UTC-8 の場合は
-0800
たとえば、UTC-8 タイムゾーンの 2017 年 5 月 11 日、午前 12:01:59 を登録するには、次の形式を使用します。
2017-05-11T00:01:59-0800
時刻を指定しなかった場合は、その日の終了時刻（23:59:59）が使用されます。
タイムゾーンを指定しなかった場合は、デフォルトのタイムゾーンが使用されます。
- テキスト フィードと XML フィードでは、対象国のデフォルトのタイムゾーンが使用されます。
- API では UTC が使用されます。
| 国 | テキスト フィードと XML フィードのデフォルトのタイムゾーン |
|---|---|
| オーストラリア | +1000 |
| ブラジル | -0300 |
| カナダ | -0500 |
| 中央ヨーロッパの国 | +0100 |
| 日本 | +0900 |
| メキシコ | -0600 |
| ニュージーランド | +1200 |
| ロシア | +0400 |
| シンガポール | +0800 |
| イギリス | Z または +00:00 |
| 米国 | -0800 |
日付範囲の形式
一部の属性では、開始日と終了日を含む日付範囲を使用できます。日付範囲は、「開始日/終了日」のようにスラッシュ（/）で区切った開始日と終了日です。
例:
- 太平洋標準時間の場合:
2017-05-11T00:01:59-0800/2017-06-21T22:13:59-0800 - 中央ヨーロッパ時間の場合:
2017-02-24T11:07:31+0100
時刻を指定しなかった場合、開始日では 00:00:00、終了日では 23:59:59 が使用されます。
