Przeczytaj ten artykuł, aby dowiedzieć się, jak formatować daty i godziny, gdy przesyłasz dane produktów. Daty i godziny podajesz w przypadku takich atrybutów jak data dostępności [availability_date], okres obowiązywania ceny promocyjnej [sale_price_effective_date] oraz data ważności [expiration_date].
Na tej stronie
Jak to działa
Użyj standardu ISO 8601, który został dokładnie opisany w tym artykule. Zależnie od atrybutu podajesz datę lub zakres dat; możesz też określić konkretną godzinę.
Formatowanie daty
Podawaj daty w tym formacie:
RRRR-MM-DD
Przykładowo datę 11 maja 2017 r. podaj w następujący sposób:
2017-05-11
Podawanie godziny
Aby wraz z datą podać określoną godzinę:
- Po dacie wpisz literę
T. - Podaj godzinę w formacie 24-godzinnym:
gg:mm:ss, na przykład:13:00:14. - Po czasie dodaj strefę czasową. Na przykład dla czasu UTC-8 użyj:
-0800.
Przykładowo 11 maja 2017 r., godz. 00:01:59 dla strefy czasowej UTC-8 zapisz w ten sposób:
2017-05-11T00:01:59-0800
Jeśli nie podasz godziny, użyjemy ostatniej godziny przed końcem doby: 23:59:59.
Jeśli nie podasz strefy czasowej, użyjemy domyślnej:
- W plikach danych w formacie tekstowym i formacie XML zostanie użyta domyślna strefa czasowa kraju docelowego.
- W interfejsie API zostanie użyta strefa czasowa UTC.
| Kraj | Domyślna strefa czasowa dla plików danych w formacie tekstowym i formacie XML |
|---|---|
| Australia | +1000 |
| Brazylia | -0300 |
| Kanada | -0500 |
| Kraje Europy Środkowej | +0100 |
| Japonia | +0900 |
| Meksyk | -0600 |
| Nowa Zelandia | +1200 |
| Rosja | +0400 |
| Singapur | +0800 |
| Wielka Brytania | Z lub +00:00 |
| Stany Zjednoczone | -0800 |
Formatowanie zakresów dat
Niektóre atrybuty przyjmują zakresy dat obejmujące datę rozpoczęcia i zakończenia. Zakres dat to data rozpoczęcia i data zakończenia rozdzielone ukośnikiem ( / ): rozpoczęcie/zakończenie.
Na przykład:
2017-05-11T00:01:59-0800/2017-06-21T22:13:59-0800dla strefy czasu pacyficznego (PST),2017-02-24T11:07:31+0100dla strefy czasu środkowoeuropejskiego.
Jeśli nie podasz godzin, w dacie rozpoczęcia wstawiona zostanie godzina 00:00:00, a w dacie zakończenia – godzina 23:59:59.
Przykłady
Wersje
| Dane produktu dotyczące zielonej koszulki Android w rozmiarze S | |
| Atrybut | Dane produktu |
Tytuł [title] |
Koszulka Android – zielona – rozmiar S |
Cena [price] |
10.99 PLN |
Cena promocyjna [sale_price] |
9.99 PLN |
Okres obowiązywania ceny promocyjnej [sale_price_effective_date] |
2016-02-24T13:00-0800/2016-02-29T15:30-0800 |
Kolor [color] |
zielony |
Rozmiar [size] |
S |
Identyfikator [id] |
9876-S-GRN |
Identyfikator grupy produktów [item_group_id] |
9876 |
| Dane produktu dotyczące niebieskiej koszulki Android w rozmiarze S | |
| Atrybut | Dane produktu |
Tytuł [title] |
Koszulka Android – niebieska – rozmiar S |
Cena [price] |
8.99 PLN |
Cena promocyjna [sale_price] |
5.99 PLN |
Okres obowiązywania ceny promocyjnej [sale_price_effective_date] |
2016-06-23T13:00-0800/2016-02-29T15:30-0800 |
Kolor [color] |
niebieski |
Rozmiar [size] |
S |
Identyfikator [id] |
9876-S-BLU |
Identyfikator grupy produktów [item_group_id] |
9876 |
| Dane produktu dotyczące czerwonej koszulki Android w rozmiarze S | |
| Atrybut | Dane produktu |
Tytuł [title] |
Koszulka Android – czerwona – rozmiar S |
Cena [price] |
10.50 PLN |
Cena promocyjna [sale_price] |
8.99 PLN |
Okres obowiązywania ceny promocyjnej [sale_price_effective_date] |
2016-05-11T13:00-0800/2016-02-29T15:30-0800 |
Kolor [color] |
czerwony |
Rozmiar [size] |
S |
Identyfikator [id] |
9876-S-RED |
Identyfikator grupy produktów [item_group_id] |
9876 |
Produkt jest dostępny w przedsprzedaży i ma określoną datę premiery
| Dane produktu dotyczące pluszowej maskotki Android | |
| Atrybut | Dane produktu |
Dostępność [availability] |
preorder |
Data dostępności [availability_date] |
2016-12-25T13:00-0800 |
Data ważności
| Dane produktu dotyczące skórzanych ogrodniczek | |
| Atrybut | Dane produktu |
Tytuł [title] |
Skórzane ogrodniczki – brązowe – rozmiar L |
Data ważności [expiration_date] |
2016-12-25 |