Este artigo explica como formatar a data e a hora ao enviar os dados do produto. Você vai enviar datas e horários para atributos como data de disponibilidade [availability_date], data de vigência do preço promocional [sale_price_effective_date] e data de validade [expiration_date].
Nesta página
Como funciona
Use o padrão ISO 8601 que será explicado em mais detalhes neste artigo. Dependendo do atributo, você precisará enviar uma data ou período e poderá incluir uma hora específica.
Formatar uma data
Inclua a data no seguinte formato:
AAAA-MM-DD
Por exemplo, para enviar 11 de maio de 2017, use:
2017-05-11
Incluir uma hora
Para adicionar uma hora específica à data, siga estas etapas:
- Siga a data com a letra
T - Adicione a hora do dia no formato de 24 horas:
hh:mm:ss. Por exemplo:13:00:14 - Depois da hora, adicione o fuso horário. Por exemplo, para UTC-8, utilize:
-0800.
Por exemplo, para enviar 11 de maio de 2017 às 00:01:59 do fuso horário UTC-8, use:
2017-05-11T00:01:59-0800
Se você não incluir uma hora, usaremos o final do dia: 23:59:59
Se você não incluir um fuso horário, usaremos um padrão:
- Feeds de texto e XML usam o fuso horário padrão para o país de destino.
- A API usa o horário UTC.
| País | Fuso horário padrão para feeds de texto e XML |
|---|---|
| Austrália | +1000 |
| Brasil | -0300 |
| Canadá | -0500 |
| Países da Europa Central | +0100 |
| Japão | +0900 |
| México | -0600 |
| Nova Zelândia | +1200 |
| Rússia | +0400 |
| Cingapura | +0800 |
| Reino Unido | Z ou +00:00 |
| Estados Unidos | -0800 |
Formatar períodos
Alguns atributos aceitam períodos que incluem uma data de início e de término. Um período é uma data de início e de término separadas por uma barra ( / ): start/end
Por exemplo:
2017-05-11T00:01:59-0800/2017-06-21T22:13:59-0800para horário do Pacífico2017-02-24T11:07:31+0100para horário da Europa Central
Se você não incluir uma hora, as datas de início e de término serão, respectivamente, 00:00:00 e 23:59:59.
Exemplos
Variantes
| Dados do produto Camiseta Android - Verde - Pequena | |
| Atributo | Dados do produto |
Título [title] |
Camiseta Android - Verde - Pequena |
Preço [price] |
10,99 BRL |
Preço promocional [sale_price] |
9,99 BRL |
Data de vigência do preço promocional [sale_price_effective_date] |
2016-02-24T13:00-0800/2016-02-29T15:30-0800 |
Cor [color] |
verde |
Tamanho [size] |
p |
Código [id] |
9876-S-GRN |
Código do grupo de itens [item_group_id] |
9876 |
| Dados do produto Camiseta Android - Azul - Pequena | |
| Atributo | Dados do produto |
Título [title] |
Camiseta Android - Azul - Pequena |
Preço [price] |
8,99 BRL |
Preço promocional [sale_price] |
5,99 BRL |
Data de vigência do preço promocional [sale_price_effective_date] |
2016-06-23T13:00-0800/2016-02-29T15:30-0800 |
Cor [color] |
azul |
Tamanho [size] |
p |
Código [id] |
9876-S-BLU |
Código do grupo de itens [item_group_id] |
9876 |
| Dados do produto Camiseta Android - vermelha - pequena | |
| Atributo | Dados do produto |
Título [title] |
Camiseta Android - Vermelha - Pequena |
Preço [price] |
10,50 BRL |
Preço promocional [sale_price] |
8,99 BRL |
Data de vigência do preço promocional [sale_price_effective_date] |
2016-05-11T13:00-0800/2016-02-29T15:30-0800 |
Cor [color] |
vermelho |
Tamanho [size] |
p |
Código [id] |
9876-S-RED |
Código do grupo de itens [item_group_id] |
9876 |
O produto está disponível para pré-encomenda com uma data específica de lançamento
| Dados do produto para Android Squishable | |
| Atributo | Dados do produto |
Disponibilidade [availability] |
comprar na pré-venda |
Data de disponibilidade [availability_date] |
2016-12-25T13:00-0800 |
Data de validade
| Dados do produto para Lederhosen | |
| Atributo | Dados do produto |
Título [title] |
Lederhosen - Marrom - Grande |
Data de validade [expiration_date] |
2016-12-25 |