Formato de data no PHP: todos os caracteres do date()

Um formato de data no PHP é uma string em que letras representam partes da data: date('Y-m-d H:i:s') imprime algo como 2026-03-14 09:05:07. Y é o ano com 4 dígitos, m o mês, d o dia, H a hora (relógio de 24 horas), i os minutos e s os segundos; qualquer caractere que não seja uma letra de formato, como -, / ou :, é impresso como está. As mesmas strings de formato funcionam no date() e no DateTimeImmutable::format().

Mude $format e clique em Run. A data está fixa em sábado, 14 de março de 2026, às 09:05:07, para você ver exatamente o que cada letra faz:

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07');

$format = 'D, d M Y H:i';   // edit me

echo $date->format($format), "\n";
echo $date->format('Y-m-d'), "\n";
echo $date->format('d/m/Y'), "\n";
echo $date->format('l, F jS, Y'), "\n";
echo $date->format('g:i A'), "\n";

Saída:

Sat, 14 Mar 2026 09:05
2026-03-14
14/03/2026
Saturday, March 14th, 2026
9:05 AM

date($format) formata o momento atual e date($format, $timestamp) um timestamp; $date->format($format) formata um objeto de data. Todo o resto sobre datas, do strtotime() aos fusos horários, está na página sobre o date() do PHP.

Caracteres de formato de data

Cada exemplo abaixo é o resultado para 2026-03-14 09:05:07.123456 UTC.

Dia

Semana e mês

Ano

Hora

Fuso horário

Data e hora completas

A mesma tabela, ao vivo: este bloco imprime cada caractere para uma data que você escolher. Coloque o seu aniversário, uma data à tarde ou uma no fim de um ano bissexto:

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07.123456');   // try '2028-12-31 18:45'

foreach (str_split('djDlNwSzWFMmntYyLoXxHGhgisaAvuBeTPpOZIcrU') as $char) {
    echo $char, '  ', $date->format($char), "\n";
}

Imprimir letras e palavras dentro de um formato

Qualquer letra numa string de formato é lida como caractere de formato, então 'Today is l' não imprime "Today is": T, o, d, a, y, i e s são todos caracteres de formato. Coloque uma barra invertida antes de cada letra que você quer imprimir como está. Numa string entre aspas duplas, \t já é um caractere de tabulação, então use aspas simples em formatos com barras invertidas:

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07');

echo $date->format('Today is l'), "\n";            // letters read as format characters
echo $date->format('\T\o\d\a\y \i\s l'), "\n";     // escaped
echo $date->format('l \t\h\e jS \o\f F'), "\n";
echo $date->format('Y-m-d\TH:i:s'), "\n";          // a literal T between date and time

echo $date->format("l \the jS"), "\n";             // double quotes: \t is a tab, h and e are format letters

Saída:

UTC202614am26 0507 Saturday
Today is Saturday
Saturday the 14th of March
2026-03-14T09:05:07
Saturday 	09UTC 14th

Formatos de data comuns

A maior parte do código precisa só de alguns formatos. Este bloco os imprime como tabela HTML, então eles aparecem na aba Page:

<?php
$date = new DateTimeImmutable('2026-03-14 15:45:00');

$formats = [
    'Y-m-d'       => 'ISO date, sorts correctly as text',
    'Y-m-d H:i:s' => 'MySQL DATETIME',
    'm/d/Y'       => 'United States',
    'd/m/Y'       => 'UK, Europe, most of the world',
    'd.m.Y'       => 'Germany, Russia',
    'F j, Y'      => 'Long US style',
    'j F Y'       => 'Long UK style',
    'D, M j'      => 'Short, for lists',
    'g:i a'       => '12-hour clock',
    'H:i'         => '24-hour clock',
];
?>
<table border="1" cellpadding="6" style="border-collapse: collapse">
    <tr><th>Format</th><th>Result</th><th>Used for</th></tr>
<?php foreach ($formats as $format => $use): ?>
    <tr>
        <td><code><?= $format ?></code></td>
        <td><?= $date->format($format) ?></td>
        <td><?= $use ?></td>
    </tr>
<?php endforeach; ?>
</table>

Guarde e compare datas como Y-m-d ou Y-m-d H:i:s: strings nessa ordem são ordenadas do mesmo jeito que as datas, o que não acontece com strings d/m/Y.

ISO 8601, DATE_ATOM e outros formatos padrão

O PHP tem constantes para os formatos que APIs, feeds e cookies esperam. DATE_ATOM (também DateTimeInterface::ATOM) é ISO 8601 e RFC 3339, o formato que as APIs JSON usam:

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07');

echo $date->format(DATE_ATOM), "\n";               // ISO 8601
echo $date->format('c'), "\n";                     // the same, as a character
echo $date->format(DATE_RFC3339_EXTENDED), "\n";   // with milliseconds
echo $date->format(DATE_RFC2822), "\n";            // email headers
echo $date->format(DATE_RSS), "\n";                // RSS feeds
echo $date->format(DATE_COOKIE), "\n";             // cookies

echo DATE_ATOM, "\n";                              // the format string behind it

Saída:

2026-03-14T09:05:07+00:00
2026-03-14T09:05:07+00:00
2026-03-14T09:05:07.000+00:00
Sat, 14 Mar 2026 09:05:07 +0000
Sat, 14 Mar 2026 09:05:07 +0000
Saturday, 14-Mar-2026 09:05:07 UTC
Y-m-d\TH:i:sP

Também existe uma constante DATE_ISO8601, mas o offset dela não tem dois pontos (+0000), o que a ISO 8601 não permite nessa forma; use DATE_ATOM.

Formato de data japonês (Y年m月d日)

Caracteres que não são letras de formato são impressos como estão, e isso inclui kanji, então 'Y年n月j日' funciona como está escrito. n e j tiram o zero à esquerda (3月14日), m e d o mantêm (03月14日). O nome do dia é a única parte que o date() não consegue traduzir, porque só conhece nomes em inglês; mapeie o número w para a sua própria lista:

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07');
$weekdays = ['日', '月', '火', '水', '木', '金', '土'];   // w: 0 = Sunday

echo $date->format('Y年n月j日'), "\n";
echo $date->format('Y年m月d日 H時i分'), "\n";
echo $date->format('Y年n月j日'), '(', $weekdays[$date->format('w')], ")\n";
echo $date->format('Y/m/d'), "\n";

Saída:

2026年3月14日
2026年03月14日 09時05分
2026年3月14日(土)
2026/03/14

Para localização completa, incluindo nomes de meses em outros idiomas e a era japonesa (令和), o IntlDateFormatter da extensão intl formata com padrões de locale. Ele usa letras de padrão ICU (yyyy, MM, EEEE), não os caracteres do PHP desta página:

<?php
$formatter = new IntlDateFormatter('ja_JP', IntlDateFormatter::FULL, IntlDateFormatter::NONE, 'Asia/Tokyo');
echo $formatter->format(new DateTimeImmutable('2026-03-14')); // 2026年3月14日土曜日

$era = new IntlDateFormatter('ja_JP@calendar=japanese', IntlDateFormatter::LONG, IntlDateFormatter::NONE, 'Asia/Tokyo', IntlDateFormatter::TRADITIONAL);
echo $era->format(new DateTimeImmutable('2026-03-14'));       // 令和8年3月14日

Converter uma data de um formato para outro

Para transformar 14/03/2026 em 2026-03-14, faça o parse da string com o formato em que ela está escrita, usando DateTimeImmutable::createFromFormat(), e depois formate de novo. Ele usa os mesmos caracteres da tabela. Comece o formato com !, senão os campos que você não informou (a hora, aqui) são preenchidos com o momento atual:

<?php
$input = '14/03/2026';

$date = DateTimeImmutable::createFromFormat('!d/m/Y', $input);
if ($date === false) {
    exit("Not a d/m/Y date\n");
}
echo $date->format('Y-m-d H:i:s'), "\n";
echo $date->format('F j, Y'), "\n";

// The string must match the format, or you get false
var_dump(DateTimeImmutable::createFromFormat('!d/m/Y', '2026-03-14'));

// A date that does not exist overflows, and getLastErrors() says so
$feb31 = DateTimeImmutable::createFromFormat('!d/m/Y', '31/02/2026');
echo $feb31->format('Y-m-d'), "\n";
print_r(DateTimeImmutable::getLastErrors()['warnings']);

Saída:

2026-03-14 00:00:00
March 14, 2026
bool(false)
2026-03-03
Array
(
    [10] => The parsed date was invalid
)

Para datas digitadas por usuários, trate qualquer aviso do getLastErrors() como data inválida, do mesmo jeito que você trata false.

Erros comuns com formatos de data

Três bugs aparecem o tempo todo: m onde se queria i, Y e y, e deixar o strtotime() adivinhar a ordem de dia e mês. O strtotime() lê barras na ordem americana mês/dia e hífens ou pontos na ordem dia-mês, então os mesmos dígitos dão duas datas diferentes:

<?php
$date = new DateTimeImmutable('2026-03-14 09:05:07');

echo $date->format('H:m:s'), "\n";   // wrong: m is the month
echo $date->format('H:i:s'), "\n";   // right: i is the minutes
echo $date->format('d/m/y'), "\n";   // y: 2-digit year

echo date('Y-m-d', strtotime('03/04/2026')), "\n";   // m/d/Y: March 4
echo date('Y-m-d', strtotime('03-04-2026')), "\n";   // d-m-Y: April 3
var_dump(strtotime('14/03/2026'));                   // no month 14: false

Saída:

09:03:07
09:05:07
14/03/26
2026-03-04
2026-04-03
bool(false)

Quando você sabe o formato da entrada, diga isso com o createFromFormat() em vez de deixar o strtotime() adivinhar.