Mutação Formatar data
A mutação Formatar data permite transformar um valor de data em um texto com um formato específico. Ela aceita datas, timestamps Unix e textos de data, e retorna um texto formatado. Ela é útil para garantir que as datas do seu feed de produtos tenham o formato exigido por cada canal de anúncios.
WARNING
Se o valor de entrada não puder ser lido como uma data, a mutação não vai retornar nenhum valor.
Opções
- Formato: O formato aplicado à data. Escolha um formato predefinido ou selecione "Personalizado" para digitar sua própria string de tokens.
Formatos predefinidos
| Formato predefinido | Exemplo de resultado | String de tokens |
|---|---|---|
| ISO 8601 | 2026-03-18T14:05:09+0000 | YYYY-MM-DDTHH:mm:ssZ |
| Data (ISO) | 2026-03-18 | YYYY-MM-DD |
| Data (EUA) | 03/18/2026 | MM/DD/YYYY |
| Data (UE) | 18/03/2026 | DD/MM/YYYY |
| Data e hora (EUA) | 03/18/2026 02:05 PM | MM/DD/YYYY hh:mm A |
| Data e hora (UE) | 18/03/2026 14:05 | DD/MM/YYYY HH:mm |
| Timestamp Unix | 1742306709 | X |
| Timestamp Unix (ms) | 1742306709000 | x |
| RFC 2822 | Wed, 18 Mar 2026 14:05:09 +0000 | ddd, DD MMM YYYY HH:mm:ss Z |
| Personalizado | (seu próprio formato) | (qualquer combinação de tokens) |
Tokens de formato personalizado
Com a opção "Personalizado", você pode combinar os seguintes tokens:
| Token | Significado | Exemplo |
|---|---|---|
YYYY | Ano com 4 dígitos | 2026 |
YY | Ano com 2 dígitos | 26 |
MMMM | Nome completo do mês | March |
MMM | Mês abreviado | Mar |
MM | Mês com zero à esquerda | 03 |
M | Mês sem zero à esquerda | 3 |
dddd | Nome completo do dia da semana | Wednesday |
ddd | Dia da semana abreviado | Wed |
DD | Dia com zero à esquerda | 18 |
D | Dia sem zero à esquerda | 18 |
HH | Hora no formato de 24 horas | 14 |
hh | Hora no formato de 12 horas com zero à esquerda | 02 |
h | Hora no formato de 12 horas | 2 |
mm | Minutos | 05 |
ss | Segundos | 09 |
A | AM/PM em maiúsculas | PM |
a | am/pm em minúsculas | pm |
ZZ | Fuso horário com dois-pontos | +00:00 |
Z | Fuso horário | +0000 |
X | Timestamp Unix (segundos) | 1742306709 |
x | Timestamp Unix (milissegundos) | 1742306709000 |
INFO
X e x são tokens especiais que não podem ser combinados com outros tokens. Se você usá-los, a string de formato inteira precisa ser apenas X ou x.
Texto literal
Coloque qualquer texto entre colchetes para incluí-lo no resultado exatamente como está, sem substituir tokens:
[Today is] dddd, MMMM DD YYYY, h:mm:ss a → Today is Wednesday, March 18 2026, 2:05:09 pm
Exemplo
Formatar o on_sale_to de um produto como MM/DD/YYYY.
