PHP date(): obter, formatar e calcular datas

date('Y-m-d') retorna a data de hoje como string, por exemplo 2026-03-14. O primeiro argumento é uma string de formato em que cada letra representa uma parte da data (Y o ano, m o mês, d o dia, H:i:s a hora), e um segundo argumento opcional é um timestamp Unix para formatar no lugar do momento atual.

<?php
echo date('Y-m-d'), "\n";          // today's date
echo date('H:i:s'), "\n";          // current time, 24-hour clock
echo date('Y-m-d H:i:s'), "\n";    // both, the format databases use
echo date('l, F jS, Y'), "\n";     // long form, e.g. Saturday, March 14th, 2026
echo time(), "\n";                 // seconds since 1970-01-01 00:00:00 UTC

A saída muda cada vez que você clica em Run, porque é a data e a hora atuais em UTC. Cada letra da string de formato, e como colocar texto comum entre elas, está na página sobre o formato de data no PHP.

Timestamps: time(), mktime() e strtotime()

Um timestamp Unix é o número de segundos desde 1º de janeiro de 1970 à meia-noite UTC. time() retorna o atual, mktime(hour, minute, second, month, day, year) monta um a partir das partes, e strtotime() lê uma data escrita em inglês ('2026-03-14', '+1 week', 'next monday'). Passe qualquer timestamp como segundo argumento do date(). O segundo argumento do strtotime() é o momento a partir do qual uma frase relativa conta; sem ele, conta a partir de agora.

<?php
$ts = mktime(9, 30, 0, 3, 14, 2026);   // 2026-03-14 09:30:00
echo $ts, "\n";
echo date('D, d M Y H:i', $ts), "\n";

// mktime() rolls over: month 13 of 2026 is January 2027
echo date('Y-m-d', mktime(0, 0, 0, 13, 1, 2026)), "\n\n";

$phrases = ['tomorrow', '+1 week', 'next monday', 'last day of this month', 'first monday of next month'];
foreach ($phrases as $phrase) {
    echo str_pad($phrase, 28), date('D Y-m-d', strtotime($phrase, $ts)), "\n";
}

var_dump(strtotime('not a date'));   // false: check before you use it

Saída:

1773480600
Sat, 14 Mar 2026 09:30
2027-01-01

tomorrow                    Sun 2026-03-15
+1 week                     Sat 2026-03-21
next monday                 Mon 2026-03-16
last day of this month      Tue 2026-03-31
first monday of next month  Mon 2026-04-06
bool(false)

O transbordo no mktime() é útil: o dia 0 de um mês é o último dia do mês anterior, então mktime(0, 0, 0, 3, 0, 2026) é 28 de fevereiro. Sempre compare o resultado com false antes de passá-lo adiante: date('Y-m-d', false) imprime em silêncio 1970-01-01, uma data que ninguém quis.

Somar dias a uma data

Para qualquer coisa além de imprimir, use DateTimeImmutable. O método modify() dele recebe as mesmas frases que o strtotime() e retorna uma nova data, e add() recebe um DateInterval como P7D (um período de 7 dias) ou PT90M (90 minutos).

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

echo $date->modify('+7 days')->format('Y-m-d'), "\n";
echo $date->modify('-1 day')->format('Y-m-d'), "\n";
echo $date->add(new DateInterval('P1M'))->format('Y-m-d'), "\n";
echo $date->add(new DateInterval('PT90M'))->format('H:i'), "\n";
echo $date->sub(new DateInterval('P1Y'))->format('Y-m-d'), "\n";

// Adding a month to January 31 overflows into March
$jan31 = new DateTimeImmutable('2026-01-31');
echo $jan31->modify('+1 month')->format('Y-m-d'), "\n";
echo $jan31->modify('last day of next month')->format('Y-m-d'), "\n";

Saída:

2026-03-21
2026-03-13
2026-04-14
11:00
2025-03-14
2026-03-03
2026-02-28

31 de fevereiro não existe, então +1 month a partir de 31 de janeiro cai em 3 de março. Quando você quer dizer "o fim do mês que vem", diga isso com last day of next month.

DateTime ou DateTimeImmutable

O DateTime altera a si mesmo quando você chama modify(), add() ou setDate(), e retorna o mesmo objeto. Isso surpreende quem guarda a data original numa variável:

<?php
$start = new DateTime('2026-03-14');
$end = $start->modify('+7 days');

echo $start->format('Y-m-d'), "\n";   // the start moved too
echo $end->format('Y-m-d'), "\n";
var_dump($start === $end);            // the same object

$start = new DateTimeImmutable('2026-03-14');
$end = $start->modify('+7 days');

echo $start->format('Y-m-d'), "\n";   // unchanged
echo $end->format('Y-m-d'), "\n";

Saída:

2026-03-21
2026-03-21
bool(true)
2026-03-14
2026-03-21

Prefira DateTimeImmutable em código novo. As duas classes têm os mesmos métodos e as duas implementam DateTimeInterface, então uma função pode aceitar qualquer uma delas.

Diferença entre duas datas

O diff() retorna um DateInterval. A propriedade days dele é o número total de dias entre as duas datas, enquanto y, m e d dividem o intervalo em anos, meses e dias, exatamente o que um cálculo de idade precisa. Mude as datas e rode de novo:

<?php
$birthday = new DateTimeImmutable('1990-07-20');
$today = new DateTimeImmutable('2026-03-14');

$age = $birthday->diff($today);
echo "Age: {$age->y}\n";
echo "Exactly: {$age->y} years, {$age->m} months, {$age->d} days\n";
echo "Days alive: {$age->days}\n";

$christmas = new DateTimeImmutable('2026-12-25');
$wait = $today->diff($christmas);
echo $wait->days, " days to go\n";
echo $wait->format('%m months and %d days'), "\n";

// Reversed order: invert is 1 and %R prints the sign
echo $christmas->diff($today)->format('%R%a days'), "\n";

Saída:

Age: 35
Exactly: 35 years, 7 months, 22 days
Days alive: 13021
286 days to go
9 months and 11 days
-286 days

No format(), %a é o total de dias e %d é só a parte dos dias, então %a é o que se usa para "dias até". Para comparar duas datas sem calcular a diferença, os operadores comuns funcionam com objetos de data: $today < $christmas é true.

Fusos horários

O date() e o new DateTimeImmutable() usam o fuso horário padrão, que vem do date.timezone no php.ini (UTC quando não está definido). Defina-o para o script inteiro com date_default_timezone_set(), ou dê a uma única data o próprio DateTimeZone e converta com setTimezone():

<?php
$meeting = new DateTimeImmutable('2026-03-14 09:30', new DateTimeZone('UTC'));

foreach (['Asia/Tokyo', 'Europe/Berlin', 'America/New_York'] as $zone) {
    $local = $meeting->setTimezone(new DateTimeZone($zone));
    echo str_pad($zone, 18), $local->format('Y-m-d H:i T P'), "\n";
}

date_default_timezone_set('Asia/Tokyo');
echo date_default_timezone_get(), "\n";
echo date('Y-m-d H:i', $meeting->getTimestamp()), "\n";

Saída:

Asia/Tokyo        2026-03-14 18:30 JST +09:00
Europe/Berlin     2026-03-14 10:30 CET +01:00
America/New_York  2026-03-14 05:30 EDT -04:00
Asia/Tokyo
2026-03-14 18:30

Um timestamp é o mesmo número em qualquer lugar; o fuso horário só muda como ele é escrito. É por isso que o conselho comum é guardar datas em UTC e converter na hora de exibir.

Mostrar um calendário numa página web

Datas costumam ser impressas em HTML. Este bloco desenha o mês atual como calendário e destaca o dia de hoje. Rode e clique em Previous ou Next: o mesmo script roda de novo com $_GET['m'] definido pelo link, como ?m=2026-04.

<?php
$month = $_GET['m'] ?? date('Y-m');
$first = DateTimeImmutable::createFromFormat('!Y-m', $month)
    ?: new DateTimeImmutable('first day of this month midnight');

$prev = $first->modify('-1 month')->format('Y-m');
$next = $first->modify('+1 month')->format('Y-m');
$today = date('Y-m-d');
$days = (int) $first->format('t');   // days in this month
?>
<style>
    th, td { width: 2.4em; padding: 4px; text-align: center; }
    .today { background: #ffd54f; border-radius: 4px; }
</style>
<h3><?= $first->format('F Y') ?></h3>
<p><a href="?m=<?= $prev ?>">Previous</a> | <a href="?m=<?= $next ?>">Next</a></p>
<table>
    <tr><th>Mon</th><th>Tue</th><th>Wed</th><th>Thu</th><th>Fri</th><th>Sat</th><th>Sun</th></tr>
    <tr>
<?php
echo str_repeat('<td></td>', (int) $first->format('N') - 1);
for ($day = 1; $day <= $days; $day++) {
    $date = $first->modify('+' . ($day - 1) . ' days');
    $class = $date->format('Y-m-d') === $today ? ' class="today"' : '';
    echo "<td$class>$day</td>";
    if ($date->format('N') === '7' && $day < $days) {
        echo "</tr>\n<tr>";
    }
}
?>
    </tr>
</table>

format('N') dá o dia da semana de 1 (segunda) a 7 (domingo), que é a quantidade de células vazias antes do dia 1º, e format('t') dá o número de dias do mês. O ! em '!Y-m' zera todos os campos que o formato não menciona, então o dia é o 1º e a hora é meia-noite.

Erros comuns com date()

O segundo argumento do date() precisa ser um timestamp, não uma string de data. Esta linha:

<?php
echo date('d/m/Y', '2026-03-14');

interrompe o script com um TypeError:

PHP Fatal error:  Uncaught TypeError: date(): Argument #2 ($timestamp) must be of type ?int, string given in /home/index.php:2

Converta a string antes, com strtotime() ou com um objeto:

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

echo date('d/m/Y', strtotime($input)), "\n";
echo (new DateTimeImmutable($input))->format('d/m/Y'), "\n";

// Check that a date really exists before using it
var_dump(checkdate(2, 29, 2026));   // 2026 is not a leap year
var_dump(checkdate(2, 29, 2028));

Saída:

14/03/2026
14/03/2026
bool(false)
bool(true)

Mais dois para ficar de olho: m é o mês e i são os minutos, então 'H:m' imprime o mês onde você queria os minutos; e new DateTimeImmutable('garbage') lança uma exceção em vez de retornar false, então envolva entradas do usuário em try/catch ou faça o parse com DateTimeImmutable::createFromFormat(), que retorna false quando não bate.