{"id":1038,"date":"2024-05-20T19:51:30","date_gmt":"2024-05-20T22:51:30","guid":{"rendered":"https:\/\/thiagorossi.com.br\/blog\/?p=1038"},"modified":"2025-12-02T17:03:26","modified_gmt":"2025-12-02T20:03:26","slug":"datas-no-php","status":"publish","type":"post","link":"https:\/\/thiagorossi.com.br\/blog\/datas-no-php\/","title":{"rendered":"Datas no PHP"},"content":{"rendered":"Tempo de leitura: <\/span> 4<\/span> minutos<\/span><\/span>\n

Datas no PHP<\/strong>: O gerenciamento de datas e hor\u00e1rios \u00e9 uma necessidade universal em aplica\u00e7\u00f5es web, desde registrar o momento de uma transa\u00e7\u00e3o at\u00e9 agendar tarefas futuras. O PHP<\/strong> fornece ferramentas duais para essa tarefa: um conjunto de fun\u00e7\u00f5es b\u00e1sicas<\/strong> herdadas e a classe moderna DateTime<\/code><\/strong>, que oferece uma abordagem mais orientada a objetos, robusta e consciente de fusos hor\u00e1rios.<\/p>\n\n\n\n

<\/div>\n\n\n\n

1. \ud83d\udcc5 Fun\u00e7\u00f5es B\u00e1sicas de Data e Tempo<\/h2>\n\n\n\n

As fun\u00e7\u00f5es legadas (date<\/code>, time<\/code>, strtotime<\/code>) s\u00e3o \u00fateis para tarefas r\u00e1pidas, mas s\u00e3o baseadas no Timestamp Unix<\/strong>, que \u00e9 o n\u00famero de segundos desde 1\u00ba de janeiro de 1970 (Era Unix).<\/p>\n\n\n\n

Fun\u00e7\u00e3o<\/strong><\/td>Prop\u00f3sito<\/strong><\/td>Exemplo PHP<\/strong><\/td><\/tr><\/thead>
time()<\/code><\/strong><\/td>Retorna o timestamp Unix<\/strong> atual (inteiro).<\/td>echo time();<\/code><\/td><\/tr>
date(formato, timestamp)<\/code><\/strong><\/td>Formata um timestamp em uma string<\/em> leg\u00edvel. Se $timestamp<\/code> for omitido, usa o tempo atual.<\/td>echo date(\"d\/m\/Y H:i:s\");<\/code><\/td><\/tr>
strtotime(string)<\/code><\/strong><\/td>Converte uma string<\/em> de data leg\u00edvel (em ingl\u00eas) para um timestamp Unix<\/strong>.<\/td>$ts = strtotime(\"tomorrow\");<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n

Exemplo de Convers\u00e3o<\/h3>\n\n\n\n

PHP<\/p>\n\n\n\n

<?php\n\/\/ Converter uma string para timestamp\n$timestamp = strtotime(\"2023-11-29 10:30:00\");\n\n\/\/ Usar o timestamp para formatar a data\necho date(\"d\/m\/Y\", $timestamp); \/\/ Sa\u00edda: 29\/11\/2023\n?>\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
2. \ud83d\udd70\ufe0f A Classe DateTime<\/code>: Orienta\u00e7\u00e3o a Objetos<\/h2>\n\n\n\n
A classe DateTime<\/code><\/strong> e suas classes relacionadas s\u00e3o a maneira preferida<\/strong> e mais poderosa de lidar com datas em PHP moderno, pois oferecem controle total sobre fusos hor\u00e1rios e c\u00e1lculos complexos.<\/p>\n\n\n\n
<\/div>\n\n\n\n
A. Cria\u00e7\u00e3o e Formata\u00e7\u00e3o<\/h3>\n\n\n\n
Para usar DateTime<\/code>, voc\u00ea cria um objeto, que encapsula a data e hora.<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
<?php\n\/\/ 1. Criar um objeto DateTime (data e hora atuais)\n$data = new DateTime();\n\n\/\/ 2. Formatar a sa\u00edda (utilizando o m\u00e9todo format())\necho $data->format('Y-m-d H:i:s'); \/\/ Ex: 2025-12-02 19:38:00\n\n\/\/ 3. Criar com uma data espec\u00edfica\n$dataEspecifica = new DateTime('2024-05-15');\necho $dataEspecifica->format('l, d\/m\/Y'); \/\/ Ex: Wednesday, 15\/05\/2024\n?>\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
B. Fusos Hor\u00e1rios (DateTimeZone<\/code>)<\/h3>\n\n\n\n
A classe DateTime<\/code> \u00e9 time zone aware<\/em> (consciente de fuso hor\u00e1rio), garantindo precis\u00e3o em sistemas globais.<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
<?php\n\/\/ Criar um objeto DateTime com fuso hor\u00e1rio espec\u00edfico\n$fusoBrasilia = new DateTimeZone('America\/Sao_Paulo');\n$data = new DateTime('now', $fusoBrasilia);\n\necho $data->format('Y-m-d H:i:s T'); \/\/ 'T' mostra a abrevia\u00e7\u00e3o do fuso.\n?>\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
3. \u2795 C\u00e1lculos de Data e Intervalos<\/h2>\n\n\n\n
Em vez de manipular timestamps<\/em> manualmente para somar ou subtrair per\u00edodos, a classe DateInterval<\/code><\/strong> permite c\u00e1lculos sem erros.<\/p>\n\n\n\n
<\/div>\n\n\n\n
A. Modificando Datas (add<\/code> e sub<\/code>)<\/h3>\n\n\n\n
Voc\u00ea usa DateInterval<\/code><\/strong> para definir o per\u00edodo que deseja adicionar ou subtrair. O formato do intervalo (P1M<\/code>) segue o padr\u00e3o ISO 8601, onde P<\/code> significa Per\u00edodo, Y<\/code> ano, M<\/code> m\u00eas, D<\/code> dia.<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
<?php\n$dataAtual = new DateTime();\necho \"Data Inicial: \" . $dataAtual->format('Y-m-d') . \"<br>\";\n\n\/\/ Adiciona 1 m\u00eas (P1M)\n$dataAtual->add(new DateInterval('P1M')); \necho \"Ap\u00f3s Adicionar 1 M\u00eas: \" . $dataAtual->format('Y-m-d') . \"<br>\";\n\n\/\/ Subtrai 5 dias (P5D)\n$dataAtual->sub(new DateInterval('P5D')); \necho \"Ap\u00f3s Subtrair 5 Dias: \" . $dataAtual->format('Y-m-d');\n?>\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
B. Diferen\u00e7a entre Datas (diff<\/code>)<\/h3>\n\n\n\n
O m\u00e9todo diff()<\/code><\/strong> retorna um objeto DateInterval<\/code><\/strong> que representa a diferen\u00e7a exata entre duas datas.<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
<?php\n$data1 = new DateTime('2023-11-29');\n$data2 = new DateTime('2023-12-10');\n\n\/\/ Calcula a diferen\u00e7a entre data2 e data1\n$intervalo = $data2->diff($data1);\n\n\/\/ O m\u00e9todo format() do DateInterval usa especificadores com '%'\necho $intervalo->format('O intervalo \u00e9 de %a dias (ou %y anos, %m meses e %d dias).'); \n\/\/ Sa\u00edda: O intervalo \u00e9 de 11 dias (ou 0 anos, 0 meses e 11 dias).\n?>\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
4. \ud83d\udcdd Tabela de Formata\u00e7\u00e3o Comum<\/h2>\n\n\n\n
O m\u00e9todo format()<\/code><\/strong> aceita diversas letras para personalizar a sa\u00edda da data e hora.<\/p>\n\n\n\n
Formato<\/strong><\/td>Descri\u00e7\u00e3o<\/strong><\/td>Exemplo de Sa\u00edda<\/strong><\/td><\/tr><\/thead>
d\/m\/Y<\/code><\/strong><\/td>Data (dia\/m\u00eas\/ano com 4 d\u00edgitos)<\/td>02\/12\/2025<\/td><\/tr>
Y-m-d H:i:s<\/code><\/strong><\/td>Formato SQL \/ ISO 8601<\/td>2025-12-02 19:38:00<\/td><\/tr>
l<\/code><\/strong><\/td>Nome completo do dia da semana<\/td>Tuesday<\/td><\/tr>
F<\/code><\/strong><\/td>Nome completo do m\u00eas<\/td>December<\/td><\/tr>
a<\/code><\/strong> ou A<\/code><\/strong><\/td>am\/pm em min\u00fasculo ou mai\u00fasculo<\/td>pm ou PM<\/td><\/tr>
U<\/code><\/strong><\/td>Timestamp Unix (segundos)<\/td>1701358080<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
5. \u2705 Boas Pr\u00e1ticas<\/h2>\n\n\n\n