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-0800
para horário do Pacífico2017-02-24T11:07:31+0100
para 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 - amarela - pequena | |
Atributo | Dados do produto |
Título [title] |
Camiseta Android - Amarelo - 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-YEL |
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] |
preorder [pré-encomenda] |
Data de disponibilidade [availability_date] |
2016-12-25T13:00-0800 |
Data de validade
Dados do produto de leite | |
Atributo | Dados do produto |
Título [title] |
Leite de vaca com baixo teor de gorduras: 500 ml |
Data de validade [expiration_date] |
2016-12-25 |