Formatar data e hora

Este artigo explica como formatar a data e a hora ao enviar os dados do produto. Você precisará enviar data e hora para atributos como availability_date [data_de_disponibilidade], sale_price_effective_date [data_efetiva_de_preço_promocional] e expiration_date [data_de_validade]

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:

  1. Adicione a letra T após a data.
  2. Adicione a hora do dia no formato de 24 horas: hh:mm:ss. Por exemplo: 13:00:14.
  3. 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 seu 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ífico
  • 2017-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

An example of ads without placeholder images
Produto Camiseta Android
title [título] Camiseta Android - Verde - Pequena
price [preço] 10.99 BRL
sale_price [preço_promocional] 9.99 BRL
sale_price_effective_date [data_efetiva_de_preço_promocional] 2016-02-24T13:00-0800/2016-02-29T15:30-0800
color [cor] verde
size P
id [código] 9876-S-GRN
item_group_id [código_de_grupo] 9876

 

Produto Camiseta Android
title [título] Camiseta Android - Azul - Pequena
price [preço] 8.99 BRL
sale_price [preço_promocional] 5.99 BRL
sale_price_effective_date [data_efetiva_de_preço_promocional] 2016-06-23T13:00-0800/2016-02-29T15:30-0800
color [cor] azul
size P
id [código] 9876-S-BLU
item_group_id [código_de_grupo] 9876

 

Produto Camiseta Android
title [título] Camiseta Android - Vermelha - Pequena
price [preço] 10.50 BRL
sale_price [preço_promocional] 8.99 BRL
sale_price_effective_date [data_efetiva_de_preço_promocional] 2016-05-11T13:00-0800/2016-02-29T15:30-0800
color [cor] vermelho
size [tamanho] P
id [código] 9876-S-RED
item_group_id [código_de_grupo] 9876

O produto está disponível para pré-encomenda com uma data específica de lançamento

Produto Android Squishable
availability [disponibilidade] preorder [pré_encomenda]
availability_date [data_de_disponibilidade] 2016-12-25T13:00-0800 

Data de validade

An example ad showing how you can select different sizes for a product
Produto Lederhosen
title [título] Lederhosen - Marrom - Grande
expiration_date [data_de_validade] 2016-12-25

Isso foi útil?
Como podemos melhorá-lo?