ACF Date Picker formato: corrigir data no WordPress

Tipo Page Builders

Nome do erro Date Picker do ACF PRO nao formata a data corretamente EN: ACF PRO Date Picker not formatting date correctly

Severidade Informativo

Descrição O ACF Date Picker formato sai errado quando o template usa o valor cru salvo no banco, que o ACF PRO sempre grava como Ymd (AAAAMMDD), em vez de aplicar o Return Format ou converter a string com DateTime antes de exibir.

O que é Date Picker que não formata a data no ACF PRO?

O ACF Date Picker formato de data envolve três configurações distintas do campo Date Picker no ACF PRO: o Display Format, que controla como a data aparece no calendário ao selecionar, o Return Format, que define o formato da string devolvida ao carregar o valor com get_field, e o valor real gravado no banco. Segundo a documentação oficial do ACF, o valor e sempre salvo como Ymd (AAAAMMDD) no banco, independente do que o usuário ve no painel.

O problema de formatacao aparece quando o template ignora essa separacao. Se o código le o valor cru ou usa um Return Format diferente do esperado, a data sai como 20260617 em vez de 17/06/2026, ou simplesmente não bate com o formato configurado. A solução passa por alinhar o Return Format do campo e, quando precisa de um formato dinâmico no template, converter a string Ymd para um objeto DateTime antes de exibir.

Como identificar

A data aparece no template como um número cru no formato 20260617 em vez de uma data legivel como 17/06/2026.
O valor exibido não corresponde ao Display Format escolhido no campo, mostrando outro formato ao renderizar no frontend.
Ao alterar o Return Format no painel do ACF, as datas já salvas continuam saindo no formato antigo no template.
A função date() ou DateTime gera o aviso ‘Failed to parse time string’ porque recebe a string Ymd em vez de um timestamp valido.
No JavaScript do calendário a data selecionada não respeita o formato configurado quando o Display Format usa caracteres especiais como o @ do PHP.

Antes de começar: Antes de alterar o Return Format de campos já em uso ou editar o functions.php em producao, faça um backup do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging. Mudar o Return Format afeta como o valor e lido em todos os templates que usam o campo.

Como prevenir

Defina o Return Format do Date Picker no momento de criar o campo, já alinhado ao formato que o template vai exibir, para não depender de conversao no código.
Lembre que o ACF sempre grava o valor como Ymd no banco: ao atualizar uma data via update_field, passe sempre a string no formato Ymd.
Padronize a conversao de datas do ACF com DateTime::createFromFormat usando Ymd como mascara, evitando passar a string crua para date() que espera timestamp.
Documente nos campos Date Picker quais usam Display Format com caracteres especiais e mantenha o filtro php_to_js_date_formats versionado no tema ou plugin.

Causa

O template le o valor cru do Date Picker, que o ACF PRO sempre grava como Ymd (AAAAMMDD) no banco segundo a doc oficial, sem aplicar o Return Format nem converter a string antes de exibir.
O Return Format do campo esta configurado com um formato diferente do que o template espera (por exemplo Ymd no campo e d/m/Y no código), entao get_field devolve a string num formato e o template assume outro.
O código passa a string Ymd direto para a função date() do PHP, que espera um timestamp Unix e não uma data formatada, retornando uma data invalida ou aviso de parse.
O Display Format e o Return Format foram trocados de lugar: o Display Format so afeta o calendário no painel e não muda o valor devolvido por get_field, que segue o Return Format.
O Display Format usa o caractere especial @ do PHP sem o filtro acf/settings/php_to_js_date_formats, fazendo o calendário JavaScript interpretar o formato de modo diferente do PHP.

Como resolver

Ajuste o Return Format do campo Date Picker: Em ACF -> Grupos de Campos, abra o campo Date Picker e defina o Return Format no formato que o template vai exibir, como d/m/Y. O Return Format e o que controla a string devolvida por get_field, e não o Display Format, que so afeta o calendário no painel.
```
Painel WP -> ACF -> Grupos de Campos -> abra o grupo e edite o campo Date Picker
Defina Return Format como d/m/Y (ou o formato desejado)
Salve o grupo de campos
```
Use get_field e confie no Return Format no template: No template, recupere o valor com get_field. A string já vem no Return Format configurado no passo anterior, entao basta exibi-la. Não leia o valor cru do banco nem reformate sem necessidade.
```
Recupere o valor: $data = get_field( 'data_evento' )
Exiba direto: echo esc_html( $data )
```
Converta a string Ymd com DateTime para formato dinâmico: Quando você precisa de um formato diferente no template sem mexer no campo, ou definiu o Return Format como Ymd, converta a string para um objeto DateTime com createFromFormat usando Ymd como mascara de entrada e depois aplique o formato de saida desejado.
```
$valor = get_field( 'data_evento' )
$date = DateTime::createFromFormat( 'Ymd', $valor )
echo $date->format( 'j M Y' )
```
Exiba a data localizada em portugues com date_i18n: Para mostrar o mes em portugues, gere o timestamp a partir do objeto DateTime e passe para date_i18n, que aplica a tradução do WordPress. Assim a data sai como 17 de junho de 2026 em vez do mes em ingles.
```
$date = DateTime::createFromFormat( 'Ymd', get_field( 'data_evento' ) )
echo date_i18n( 'j \d\e F \d\e Y', $date->getTimestamp() )
```
Trate caracteres especiais do formato com o filtro do ACF: Se o Display Format usa um caractere especial do PHP como o @ e o calendário JavaScript exibe diferente, registre o filtro acf/settings/php_to_js_date_formats para mapear o caractere PHP para o equivalente do datepicker jQuery UI, conforme a doc oficial do ACF.
```
Edite o functions.php do tema ou um plugin próprio
Adicione o filtro acf/settings/php_to_js_date_formats (ver bloco de código abaixo)
Salve e recarregue a tela de edição do campo
```

PHP

<?php
// 1) Exibir a data do ACF Date Picker no template, convertendo o Ymd salvo.
$valor = get_field( 'data_evento' );
if ( $valor ) {
    // O ACF grava sempre como Ymd (AAAAMMDD); cria o objeto a partir disso.
    $date = DateTime::createFromFormat( 'Ymd', $valor );
    if ( $date ) {
        // Data localizada em portugues via date_i18n (ex.: 17 de junho de 2026).
        echo esc_html( date_i18n( 'j \d\e F \d\e Y', $date->getTimestamp() ) );
    }
}

// 2) Caractere especial @ no Display Format: mapeia o formato PHP para o jQuery UI.
add_filter( 'acf/settings/php_to_js_date_formats', function ( $formats ) {
    $formats['@'] = '@'; // mantem o caractere intacto no datepicker
    return $formats;
} );

Perguntas frequentes

Por que o ACF Date Picker retorna a data como 20260617

Porque o ACF PRO sempre grava o valor no banco como Ymd (AAAAMMDD), segundo a documentação oficial. Se o template le o valor cru ou o Return Format esta como Ymd, a data sai nesse formato. Ajuste o Return Format ou converta a string com DateTime antes de exibir.

Qual a diferenca entre Display Format e Return Format no Date Picker

O Display Format controla apenas como a data aparece no calendário ao selecionar no painel. O Return Format define o formato da string devolvida por get_field ao carregar o valor. Para o template, o que importa e o Return Format.

Como exibir a data do ACF Date Picker no formato dia mes ano

Defina o Return Format do campo como d/m/Y, ou converta a string Ymd no template com DateTime::createFromFormat e depois aplique o format desejado, como j M Y. Assim você controla o formato de saida sem mexer no valor salvo.

Por que a função date() gera erro com a data do ACF

A função date() do PHP espera um timestamp Unix, mas o ACF devolve uma string formatada. Passe a string para DateTime::createFromFormat com a mascara Ymd e use o getTimestamp do objeto antes de qualquer função que precise de timestamp.

Como mostrar o mes em portugues na data do ACF

Converta a string Ymd para um objeto DateTime, pegue o timestamp com getTimestamp e passe para date_i18n, que aplica a tradução do WordPress conforme o idioma do site. O nome do mes sai em portugues automaticamente.

Em que formato devo salvar a data ao usar update_field no Date Picker

Sempre no formato Ymd (AAAAMMDD). A documentação do ACF afirma que ao atualizar o valor manualmente você deve usar o formato Ymd, que e como o campo armazena a data no banco, independente do Display ou Return Format.

Por que o calendário mostra a data diferente do formato PHP configurado

Quando o Display Format usa caracteres especiais do PHP como o @, o datepicker jQuery UI pode interpretar de modo diferente. Use o filtro acf/settings/php_to_js_date_formats para mapear o caractere PHP para o equivalente do JavaScript, como indica a doc do ACF.

Mudar o Return Format afeta as datas já salvas no banco

Não muda o valor no banco, que continua em Ymd. O Return Format so altera como get_field devolve a string daqui pra frente. As datas existentes voltam a sair no novo formato assim que você salva a configuração e recarrega o template.

Informativo

Como corrigir o widget Image Comparison no Essential Addons que não funciona no WordPress

O widget Image Comparison do Essential Addons não funciona quando o elemento está desativado no painel do plugin, quando faltam as imagens de antes e depois, ou quando o CSS e JS gerados estão desatualizados e o controle deslizante não inicializa no Elementor.

Atenção

Como corrigir o JetSearch que não retorna resultados relevantes no WordPress

O JetSearch deixa de retornar resultados relevantes quando o widget de busca aponta para a fonte (post type) errada, não inclui os campos certos na pesquisa ou tem um limite de resultados muito baixo, fazendo a busca ignorar produtos, custom fields e taxonomias.

Atenção

Como corrigir o Mega Menu que não exibe submenus no Astra Pro

O Mega Menu do Astra Pro deixa de exibir submenus quando o módulo Nav Menu está inativo, quando o toggle Enable Mega Menu não foi ligado no item pai ou quando os itens de submenu não estão aninhados sob o pai em Aparência -> Menus. Sem submenu aninhado, o Astra não monta as colunas e o menu abre vazio.

Atenção

Como corrigir o erro de permissão ao criar Custom Fields no JetEngine

O JetEngine erro de permissão ao criar Custom Fields ocorre quando o usuário logado não tem a capability manage_options exigida pelos menus do JetEngine, quando um plugin de segurança bloqueia o admin-ajax que salva os campos, ou quando a regra de acesso de um Custom Content Type nega a operacao.

Grave

Como corrigir o erro “Preview Could Not Be Loaded” no Elementor

O erro "Preview Could Not Be Loaded" aparece quando o editor do Elementor não consegue carregar a página dentro do iframe de preview. O próprio aviso costuma apontar a causa: tema ausente, .htaccess corrompido, código HTTP de erro ou a página de posts definida como página estática.

Informativo

Como corrigir o Scroll to Top que não funciona no Astra Pro

O Scroll to Top Astra Pro não funciona quando o botão está desativado para o dispositivo atual no Customizer, quando o JavaScript do tema é bloqueado por um plugin de cache, ou quando outro plugin de voltar ao topo entra em conflito com o do Astra.

Setores

Extensões

Integrações

Como corrigir o Date Picker que não formata a data no ACF PRO

O que é Date Picker que não formata a data no ACF PRO?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o widget Image Comparison no Essential Addons que não funciona no WordPress

Como corrigir o JetSearch que não retorna resultados relevantes no WordPress

Como corrigir o Mega Menu que não exibe submenus no Astra Pro

Como corrigir o erro de permissão ao criar Custom Fields no JetEngine

Como corrigir o erro “Preview Could Not Be Loaded” no Elementor

Como corrigir o Scroll to Top que não funciona no Astra Pro

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos