באיזה פורמט להזין תאריך ושעה

המאמר הזה מסביר באיזה פורמט יש להזין תאריכים ושעות בנתוני מוצרים לפני ששולחים אותם. תאריכים ושעות רלוונטיים למשל במאפיינים של תאריך זמינות [availability_date], תאריכי התוקף של מחיר המבצע [sale_price_effective_date] ותאריך תפוגה [expiration_date].

בדף הזה

איך זה עובד
הפורמט של תאריכים
הוספת שעה
דוגמאות

איך זה עובד

צריך להשתמש בתקן ISO 8601, שמאמר זה מרחיב עליו. בהתאם למאפיין, צריך לשלוח תאריך או טווח תאריכים, ואפשר גם להוסיף שעה ספציפית.

הפורמט של תאריכים

מוסיפים את התאריך בפורמט הבא:

YYYY-MM-DD

לדוגמה, כדי לשלוח את התאריך 11 במאי 2017, מזינים:

2017-05-11

הוספת שעה

כדי להוסיף לתאריך שעה ספציפית:

מוסיפים את האות T אחרי התאריך.
מוסיפים את השעה בפורמט של 24 שעות: (hh:mm:ss). לדוגמה: 13:00:14
אחרי השעה, מוסיפים את אזור הזמן. לדוגמה, עבור אזור זמן UTC-8, כותבים: 0800-

לדוגמה, כדי לשלוח את התאריך 11 במאי 2017 בשעה 12:01:59 בלילה באזור זמן UTC-8, מזינים:

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 עבור שעון החוף המערבי (PST)
2017-02-24T11:07:31+0100 עבור שעון מרכז אירופה.

אם לא הוספתם שעה, תאריך ההתחלה יקבל את השעה 00:00:00, ותאריך הסיום יקבל את השעה 23:59:59.

דוגמאות

וריאציות

נתוני מוצר לחולצת טישרט של Android – ירוק – מידה Small
מאפיין	נתוני המוצר
שם פריט `[title]`	טישרט של Android – ירוק – מידה Small
מחיר `[price]`	‎49.90 ILS
מחיר מבצע `[sale_price]`	‎39.90 ILS
תאריכי התוקף של מחיר המבצע `[sale_price_effective_date]`	`2016-02-24T13:00-0800/2016-02-29T15:30-0800`
צבע `[color]`	ירוק
מידה `[size]`	S
מזהה `[id]`	9876‎-S-GRN
מזהה קבוצת פריטים `[item_group_id]`	9876

נתוני מוצר לחולצת טישרט של Android – כחול – מידה Small
מאפיין	נתוני המוצר
שם פריט `[title]`	טישרט של Android – כחול – מידה Small
מחיר `[price]`	‎35.90 ILS
מחיר מבצע `[sale_price]`	‎25.90 ILS
תאריכי התוקף של מחיר המבצע `[sale_price_effective_date]`	`2016-06-23T13:00-0800/2016-02-29T15:30-0800`
צבע `[color]`	כחול
מידה `[size]`	S
מזהה `[id]`	9876‎-S-BLU
מזהה קבוצת פריטים `[item_group_id]`	9876

נתוני מוצר לחולצת טישרט של Android – אדום – מידה Small
מאפיין	נתוני המוצר
שם פריט `[title]`	טישרט של Android – אדום – מידה Small
מחיר `[price]`	‎42.90 ILS
מחיר מבצע `[sale_price]`	‎35.90 ILS
תאריכי התוקף של מחיר המבצע `[sale_price_effective_date]`	`2016-05-11T13:00-0800/2016-02-29T15:30-0800`
צבע `[color]`	אדום
מידה `[size]`	S
מזהה `[id]`	RED-‏S-‏9876
מזהה קבוצת פריטים `[item_group_id]`	9876

מוצר שאפשר להזמין מראש בתאריך השקה ספציפי

נתוני מוצר לכדור מעיכה Android
מאפיין	נתוני המוצר
זמינות `[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`

האם המידע הועיל?

איך נוכל לשפר את המאמר?