В этой статье речь пойдет о том, как правильно указать дату и время в атрибутах 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. - Добавьте сведения о часовом поясе. Например, для североамериканского тихоокеанского времени нужно указать
-0800.
Дата и время 11 мая 2017 года, 00:01:59 по североамериканскому тихоокеанскому времени будут выглядеть так:
2017-05-11T00:01:59-0800
Если вы не укажете время, будет автоматически использовано значение 23:59:59.
Если вы не добавите сведения о часовом поясе, по умолчанию будут использованы следующие значения:
- в текстовых фидах и фидах в формате XML – часовой пояс целевой страны фида;
- в фидах API – всемирное координированное время.
| Страна | Часовой пояс по умолчанию для текстовых фидов и фидов XML |
|---|---|
| Австралия | +1000 |
| Бразилия | -0300 |
| Канада | -0500 |
| Страны Центральной Европы | +0100 |
| Япония | +0900 |
| Мексика | -0600 |
| Новая Зеландия | +1200 |
| Россия | +0400 |
| Сингапур | +0800 |
| Великобритания | Z или +00:00 |
| Соединенные Штаты Америки | -0800 |
Как оформить диапазон дат
Значения некоторых атрибутов включают не просто дату, а временной промежуток, ограниченный датой начала и датой окончания. Эти две даты нужно разделять знаком /. Вот как это выглядит: start/end [начало/окончание].
Примеры:
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 |
title [название] |
Зеленая футболка с логотипом Android, размер S |
price [цена] |
1099.00 RUB |
sale_price [цена_со_скидкой] |
999.00 RUB |
sale_price_effective_date [срок_действия_скидки] |
2016–02–24T13:00–0800/2016–02–29T15:30–0800 |
color [цвет] |
green [зеленый] |
size [размер] |
S |
id [идентификатор] |
9876-S-ЗЛН |
item_group_id [идентификатор_группы_товаров] |
9876 |
| Товар | Футболка с логотипом Android |
title [название] |
Синяя футболка с логотипом Android, размер S |
price [цена] |
899.00 RUB |
sale_price [цена_со_скидкой] |
599.00 RUB |
sale_price_effective_date [срок_действия_скидки] |
2016-06-23T13:00-0800/2016-02-29T15:30-0800 |
color [цвет] |
blue [синий] |
size [размер] |
S |
id [идентификатор] |
9876-S-СИН |
item_group_id [идентификатор_группы_товаров] |
9876 |
| Товар | Футболка с логотипом Android |
title [название] |
Красная футболка с логотипом Android, размер S |
price [цена] |
1005.00 RUB |
sale_price [цена_со_скидкой] |
899.00 RUB |
sale_price_effective_date [срок_действия_скидки] |
2016-05-11T13:00-0800/2016-02-29T15:30-0800 |
color [цвет] |
red [красный] |
size [размер] |
S |
id [идентификатор] |
9876-S-КРС |
item_group_id [идентификатор_группы_товаров] |
9876 |
Товар доступен для предзаказа (дата определена)
| Товар | Мягкая игрушка Android Squishable |
availability [наличие] |
preorder [предзаказ] |
availability_date [дата_поступления] |
2016–12–25T13:00–0800 |
Срок действия
| Товар | Ледерхозе |
title [название] |
Коричневые ледерхозе, размер L |
expiration_date [срок_окончания_действия] |
2016–12–25 |