日付と時刻の設定について

この記事では、商品データを登録する場合の日付と時刻の形式について説明します。日付と時刻は、入荷予定日 [availability_date]、セール価格有効期間 [sale_price_effective_date]、有効期限 [expiration_date] などの属性で登録します。

このページの内容

• 仕組み
• 日付の形式
• 時刻の指定
• 例

---

仕組み

この記事で詳しく説明する ISO 8601 標準を使用します。属性によっては、日付または日付範囲を登録し、特定の時刻を指定することができます。

---

日付の形式

次の形式で日付を指定します。

• YYYY-MM-DD

たとえば、2017 年 5 月 11 日を登録するには、次の形式を使用します。

• 2017-05-11

---

時刻の指定

日付に特定の時刻を追加するには:

1. 日付の後に T という文字を続けます。
2. 24 時間形式（hh:mm:ss）で時刻を追加します。例: 13:00:14
3. 時刻の後にタイムゾーンを追加します。例: 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 が使用されます。

---

例