Trabalho com datas e horas em PHP: nível avançado

Trabalho avançado com datas e horas em PHP

No desenvolvimento web moderno, o tratamento correto de datas e horas não é apenas uma conveniência, mas uma tarefa criticamente importante. Seja para calcular prazos, analisar logs, trabalhar com uma audiência global ou simplesmente exibir a data de publicação, o PHP oferece ferramentas poderosas, embora nem sempre óbvias. Neste artigo, iremos além do básico date() e strtotime(), mergulhando em classes orientadas a objetos e técnicas avançadas que tornarão seu código confiável e flexível.

O material é voltado para desenvolvedores já familiarizados com os fundamentos do PHP, mas que desejam aprofundar seus conhecimentos. Abordaremos o trabalho com fusos horários, adição e subtração de intervalos, comparação de datas, além de conhecer a popular biblioteca Carbon.

1. Classe DateTime e DateTimeZone: a base de tudo

Em vez de depender de funções procedurais, o PHP moderno oferece o uso da classe orientada a objetos DateTime. Ela encapsula toda a lógica de trabalho com datas e horas, tornando o código mais legível e seguro.

A principal vantagem do DateTime é a possibilidade de vinculação a um fuso horário específico através do objeto DateTimeZone. Isso resolve o problema do tempo "flutuante" ao trabalhar com servidores localizados em diferentes regiões.

<?php\n// Criando um objeto de fuso horário para Moscou\n$timezone = new DateTimeZone('Europe/Moscow');\n\n// Criando um objeto DateTime com hora e fuso horário especificados\n$date = new DateTime('2024-12-25 10:00:00', $timezone);\n\necho $date->format('Y-m-d H:i:s'); // Exibirá: 2024-12-25 10:00:00\n?>

Se o fuso horário não for especificado, o PHP usa as configurações do servidor (date.timezone no php.ini). No entanto, para código portável, é sempre melhor defini-lo explicitamente. Você pode obter uma lista de todos os fusos horários disponíveis usando DateTimeZone::listIdentifiers().

2. Manipulações com datas: DateInterval e DatePeriod

Quando precisar adicionar ou subtrair dias, semanas ou meses, a classe DateInterval vem em socorro. Ela define um intervalo de tempo que pode ser aplicado a um objeto DateTime.

O formato de escrita do intervalo (ISO 8601 duration) pode parecer complexo, mas é muito flexível:

\n
• P — prefixo obrigatório (period).
\n
• Y — anos, M — meses, D — dias.
\n
• T — separador para tempo (se necessário).
\n
• H — horas, M — minutos, S — segundos.
\n

Exemplo: P1Y2M3DT4H5M6S significa 1 ano, 2 meses, 3 dias, 4 horas, 5 minutos e 6 segundos.

<?php\n$date = new DateTime('2024-01-01');\n$interval = new DateInterval('P10D'); // 10 dias\n\n$date->add($interval);\necho $date->format('Y-m-d'); // Exibirá: 2024-01-11\n\n// Operação inversa - subtração\n$date->sub(new DateInterval('P5D'));\necho $date->format('Y-m-d'); // Exibirá: 2024-01-06\n?>

Importante: Ao trabalhar com meses e anos, o DateInterval pode se comportar de forma não óbvia. Por exemplo, se você adicionar 1 mês a 31 de janeiro, obterá 3 de março (já que fevereiro não tem 31 dias). Para lógicas mais complexas (por exemplo, "último dia do mês"), use o método modify().

A classe DatePeriod permite gerar facilmente sequências de datas. É ideal para criar calendários ou cronogramas.

<?php\n$start = new DateTime('2024-12-01');\n$end = new DateTime('2024-12-31');\n$interval = new DateInterval('P1W'); // A cada semana\n\n$period = new DatePeriod($start, $interval, $end);\n\nforeach ($period as $date) {\n    echo $date->format('l, Y-m-d') . "\\n"; // Exibirá todas as segundas-feiras de dezembro\n}\n?>

3. Comparação e diferença entre datas<