この記事では、商品データを登録する場合の日付と時刻の形式について説明します。日付と時刻は、入荷予定日 [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
が使用されます。
例
バリエーション
Android T シャツ、緑、S サイズの商品データ | |
属性 | 商品データ |
タイトル [title] |
Android T シャツ、緑、S サイズ |
価格 [price] |
1099.00 JPY |
セール価格 [sale_price] |
999.00 JPY |
セール価格有効期間 [sale_price_effective_date] |
2016-02-24T13:00-0800/2016-02-29T15:30-0800 |
色 [color] |
緑 |
サイズ [size] |
S |
ID [id] |
9876-S-GRN |
商品グループ ID [item_group_id] |
9876 |
Android T シャツ、青、S サイズの商品データ | |
属性 | 商品データ |
タイトル [title] |
Android T シャツ、青、S サイズ |
価格 [price] |
899.00 JPY |
セール価格 [sale_price] |
599.00 JPY |
セール価格有効期間 [sale_price_effective_date] |
2016-06-23T13:00-0800/2016-02-29T15:30-0800 |
色 [color] |
青 |
サイズ [size] |
S |
ID [id] |
9876-S-BLU |
商品グループ ID [item_group_id] |
9876 |
Android T シャツ、赤、S サイズの商品データ | |
属性 | 商品データ |
タイトル [title] |
Android T シャツ、赤、S サイズ |
価格 [price] |
1050.00 JPY |
セール価格 [sale_price] |
899.00 JPY |
セール価格有効期間 [sale_price_effective_date] |
2016-05-11T13:00-0800/2016-02-29T15:30-0800 |
色 [color] |
赤 |
サイズ [size] |
S |
ID [id] |
9876-S-RED |
商品グループ ID [item_group_id] |
9876 |
予約可能な商品(具体的な発売日あり)
ドロイド君のぬいぐるみの商品データ | |
属性 | 商品データ |
在庫状況 [availability] |
preorder |
入荷予定日 [availability_date] |
2016-12-25T13:00-0800 |
有効期限
レーダーホーゼンの商品データ | |
属性 | 商品データ |
タイトル [title] |
レーダーホーゼン - ブラウン - L サイズ |
有効期限 [expiration_date] |
2016-12-25 |