Gerenciando Formatos de Data e Hora em Aplicações PHP
Guia Técnico para Desenvolvedores

O painel administrativo Bootstrap precisa lidar com diferentes formatos de data e hora dependendo da situação. Veja como funciona.


Os diferentes formatos de Data e Hora

Lista dos formatos de data, datetime e hora usados no PHP CRUD Generator

Páginas Uso Idioma Formato
Listas READ Data legível traduzida de acordo com o idioma do usuário PHP com a extensão intl habilitada ICU *
Listas READ Data legível NÃO traduzida PHP sem a extensão intl habilitada Formato de data do PHP **
Formulários CREATE / UPDATE Plugins Datepicker Javascript Formatos do plugin Pickadate ***
Objetos PHP Campos de data, hora e datetime do banco de dados PHP/MySQL Y-m-d H:i:s

*ICU - https://unicode-org.github.io/icu-docs/apidoc/released/icu4c/classSimpleDateFormat.html#details

**Lista de formatos de data do PHP: https://www.php.net/manual/en/function.date.php

***Lista de formatos de data do Pickadate: https://amsul.ca/pickadate.js/date/


Gerenciamento dos formatos de data e hora PHP/JavaScript no painel administrativo

Os formatos de data e hora do Gerador e do Painel Admin

  1. Quando você define um formato de data / hora em uma lista READ do gerador, sua escolha é armazenada em um arquivo interno (generator/database/phpcg/[sua_tabela].).

    O formato armazenado é o Javascript formato

    Os seletores de data e hora do formulário admin usarão este formato, + um campo oculto com o sufixo "_submit" para enviar os valores no formato de data / hora do MySQL.

  2. O template TWIG da lista READ precisará posteriormente converter a data / hora do valor MySQL para o formato legível.
    Para esse fim, o Javascript formato é convertido pelo gerador para PHP ICU por generator/class/generator/TemplatesUtilities.php. O PHP ICU formato gerado será passado como argumento no template TWIG para converter a data / hora MySQL para o formato legível.

    A função é pickerdateToPhpdate($pickerdate)

  3. A classe do item constrói o valor do objeto usando o PHP/MySQL formato (sem conversão de formato)

  4. o template TWIG da lista READ chama a função formatDate($date, $format) em vendor/twig/twig/lib/Twig/Extension/CrudTwigExtension.php

    O $date fornecido está em PHP/MySQL formato e pode ser uma data, uma hora ou um datetime.

    O $format é o ICU formato.

    • se a extensão PHP intl estiver habilitada, ela mostrará a data traduzida de acordo com as configurações de idioma usando a extensão IntlDateFormatter::formatObject() usando Locale::getDefault()
    • se a extensão PHP intl está não habilitada, ela converte a data / hora ICU para o formato clássico Formato de data do PHP

Exemplos aleatórios de formatos de datetime

Os datetimes abaixo são gerados a partir de um formato aleatório usando a mesma lógica do CRUD Generator.

$pickerdate
yyyy mmmm d H i A
$icu_format
yyyy MMMM d H m a
$icu_date
2026 October 13 5 23 am
$php_format
Y F j G i a
$php_date
2026 October 13 5 23 am

$pickerdate
yy mmm ddd h i a
$icu_format
yy MMM eee h m a
$icu_date
26 Oct Tue 5 23 am
$php_format
y M D g i a
$php_date
26 Oct Tue 5 23 am

$pickerdate
yy m dddd HH i a
$icu_format
yy M eeee HH m a
$icu_date
26 10 Tuesday 05 23 am
$php_format
y n l H i a
$php_date
26 10 Tuesday 05 23 am

$pickerdate
yyyy mmmm ddd hh i a
$icu_format
yyyy MMMM eee hh m a
$icu_date
2026 Outubro Ter 05 23 am
$php_format
Y F D h i a
$php_date
2026 Outubro Ter 05 23 am

$pickerdate
yy mmm dd HH i a
$icu_format
yy MMM dd HH m a
$icu_date
26 Out 13 05 23 am
$php_format
y M d H i a
$php_date
26 Out 13 05 23 am

$pickerdate
yy mmm d hh i A
$icu_format
yy MMM d hh m a
$icu_date
26 Out 13 05 23 am
$php_format
y M j h i a
$php_date
26 Out 13 05 23 am

$pickerdate
yyyy mmm ddd hh i a
$icu_format
yyyy MMM eee hh m a
$icu_date
2026 Out Ter 05 23 am
$php_format
Y M D h i a
$php_date
2026 Out Ter 05 23 am

$pickerdate
yy mm ddd H i a
$icu_format
yy MM eee H m a
$icu_date
26 10 Ter 5 23 am
$php_format
y m D G i a
$php_date
26 10 Ter 5 23 am

$pickerdate
yy mmmm dd hh i A
$icu_format
yy MMMM dd hh m a
$icu_date
26 Outubro 13 05 23 am
$php_format
y F d h i a
$php_date
26 Outubro 13 05 23 am

$pickerdate
yy m dd HH i a
$icu_format
yy M dd HH m a
$icu_date
26 10 13 05 23 am
$php_format
y n d H i a
$php_date
26 10 13 05 23 am

Página principal do tutorial PHP CRUD