تنسيق التاريخ والوقت

توضح هذه المقالة كيفية تنسيق التواريخ والأوقات عند إرسال بيانات المنتجات. يجب إرسال التواريخ والأوقات لسمات مثل تاريخ التوفّر [availability_date] وتاريخ سريان السعر المخفَّض [sale_price_effective_date] وتاريخ انتهاء الصلاحية [expiration_date].

آلية العمل

يجب اتّباع معيار ISO 8601 الموضّح بشكلٍ أكثر تفصيلاً في هذه المقالة. بالاستناد إلى السمة، يجب إرسال تاريخ أو نطاق تاريخ، ويمكنك تضمين وقت محدّد.

أدرج التاريخ بالتنسيق التالي:

على سبيل المثال، لإرسال 11 أيار (مايو) 2017، استخدم:

لإضافة وقت محدد إلى التاريخ:

على سبيل المثال، لإرسال 11 أيار (مايو) 2017 عند الساعة 12:01:59 صباحًا للمنطقة الزمنية UTC-8، استخدم:

إذا لم تدرج وقتًا، سنستخدم نهاية اليوم: 23:59:59

إذا لم تُدرج منطقة زمنية، سنستخدم منطقة زمنية تلقائية:

ستستخدم الخلاصات النصية وخلاصات XML المنطقة الزمنية التلقائية للبلد المستهدف.
ستستخدم واجهة برمجة التطبيقات التوقيت العالمي المتفق عليه (UTC).

البلد	المنطقة الزمنية التلقائية لخلاصات Text وXML
أستراليا	‎+1000
البرازيل	‎-0300
كندا	‎-0500
بلدان وسط أوروبا	‎+0100
اليابان	‎+0900
المكسيك	‎-0600
نيوزيلندا	‎+1200
روسيا	‎+0400
سنغافورة	‎+0800
المملكة المتحدة	Z أو ‎+00:00
الولايات المتحدة	‎-0800

يمكن في بعض السمات تضمين نطاقات تاريخ تشمل تاريخ بدءٍ وانتهاءٍ. نطاق التاريخ هو تاريخ بدء وتاريخ انتهاء مفصولان بشرطة مائلة ( / ): البدء/الانتهاء

على سبيل المثال:

إذا لم تُدرج وقتًا، سيستخدم تاريخ البدء 00:00:00، وسيستخدم تاريخ الانتهاء 23:59:59.

بيانات المنتج لقميص Android - أخضر - صغير
السمة	بيانات المنتج
العنوان `[title]`	قميص Android - أخضر - صغير
السعر `[price]`	10.99‎ SAR
السعر المخفَّض `[sale_price]`	‎9.99 SAR
تاريخ سريان السعر المخفَّض `[sale_price_effective_date]`	`2016-02-24T13:00-0800/2016-02-29T15:30-0800`
اللون `[color]`	أخضر
المقاس `[size]`	صغير
المعرّف `[id]`	‎9876-S-GRN
معرّف مجموعة السلع `[item_group_id]`	9876

بيانات المنتج لقميص Android - أزرق - صغير
السمة	بيانات المنتج
العنوان `[title]`	قميص Android - أزرق - صغير
السعر `[price]`	‎8.99 SAR
السعر المخفَّض `[sale_price]`	‎5.99 SAR
تاريخ سريان السعر المخفَّض `[sale_price_effective_date]`	`2016-06-23T13:00-0800/2016-02-29T15:30-0800`
اللون `[color]`	أزرق
المقاس `[size]`	صغير
المعرّف `[id]`	‎9876-S-BLU
معرّف مجموعة السلع `[item_group_id]`	9876

بيانات المنتج لقميص Android - أحمر - صغير
السمة	بيانات المنتج
العنوان `[title]`	قميص Android - أحمر - صغير
السعر `[price]`	‎10.50 SAR
السعر المخفَّض `[sale_price]`	‎8.99 SAR
تاريخ سريان السعر المخفَّض `[sale_price_effective_date]`	`2016-05-11T13:00-0800/2016-02-29T15:30-0800`
اللون `[color]`	أحمر
المقاس `[size]`	صغير
المعرّف `[id]`	‎9876-S-RED
معرّف مجموعة السلع `[item_group_id]`	9876

بيانات المنتج لدُمية Android محشوّة
السمة	بيانات المنتج
مدى التوفّر `[availability]`	`preorder`
تاريخ التوفّر `[availability_date]`	`2016-12-25T13:00-0800`

بيانات المنتج لبنطال قصير بحمّالات
السمة	بيانات المنتج
العنوان `[title]`	بنطال قصير بحمّالات - بنّي - كبير
تاريخ انتهاء الصلاحيّة `[expiration_date]`	`2016-12-25`

كيف يمكننا تحسينها؟