日付と時刻の形式

この記事では、商品データを登録する場合の日付と時刻の形式について説明します。日付と時刻は、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 が使用されます。

バリエーション

An example of ads without placeholder images
商品 Android T シャツ
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
item_group_id [商品グループ ID] 9876

 

商品 Android T シャツ
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
item_group_id [商品グループ ID] 9876

 

商品 Android T シャツ
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
item_group_id [商品グループ ID] 9876

予約可能な商品(具体的な発売日あり)

商品 ドロイド君のぬいぐるみ
availability [在庫状況] preorder [予約]
availability_date [入荷予定日] 2016-12-25T13:00-0800 

有効期限

An example ad showing how you can select different sizes for a product
商品 レーダーホーゼン
title [商品名] レーダーホーゼン - ブラウン - L サイズ
expiration_date [有効期限] 2016-12-25

この情報は役に立ちましたか?
改善できる点がありましたらお聞かせください。

さらにサポートが必要な場合

問題を迅速に解決できるよう、ログインして追加のサポート オプションをご利用ください。