Como usar PHP date para formatar data e hora

Faça uso da função PHP date() no seu site ou aplicação para formatar data e hora di­na­mi­ca­mente, da maneira que você preferir. Ela é es­pe­ci­al­mente útil para a exibição de datas e horários de pu­bli­ca­ções, para a con­fi­gu­ra­ção de cronô­me­tros de contagens re­gres­siva e para a ad­mi­nis­tra­ção de outras ações re­la­ci­o­na­das à contagem de tempo.

O que é PHP date?

PHP date é uma função integrada da linguagem de pro­gra­ma­ção, utilizada para formatar data e hora em sites e apli­ca­ções. Ao ser executada, ela retorna uma string que exibe data e hora com a for­ma­ta­ção es­pe­ci­fi­cada pelos pa­râ­me­tros pre­vi­a­mente definidos no código. A função PHP date pode ser usada, por exemplo, para a exposição de data e hora atuais ou futuras em uma página da internet. Ao recuperar in­for­ma­ções de um banco de dados MySQL/MariaDB com PHP, a função date() é capaz de exibi-las em um formato legível, recurso es­pe­ci­al­mente útil a blogs e sites de artigos e notícias.

Sintaxe da função date em PHP

A função PHP date() deve ser sempre es­tru­tu­rada da seguinte maneira, para que seja cor­re­ta­mente executada:

date(format, timestamp);

Pa­râ­me­tros da função date em PHP

Toda função PHP date() deve conter um parâmetro obri­ga­tó­rio, chamado PHP date format. O outro parâmetro, timestamp, pode ser usado de forma opcional:

• format:PHP date format é o parâmetro de string obri­ga­tó­rio, que es­pe­ci­fica como a data e a hora devem ser for­ma­ta­das. Ele contém ca­rac­te­res es­pe­cí­fi­cos, uti­li­za­dos para orientar o formato a ser exibido:
  • Y: Re­pre­senta o ano, contendo, portanto, quatro dígitos (por exemplo, 2024).
  • m: Re­pre­senta o mês do ano em formato numérico, de 01 a 12.
  • d: Re­pre­senta dia do mês em formato numérico, de 01 a 31.
  • H: Re­pre­senta a hora no formato de 24 horas, de 00 a 23.
  • i: Re­pre­senta os minutos, de 00 a 59.
  • s: Re­pre­senta os segundos, de 00 a 59.
• timestamp: Esse parâmetro (carimbo de data/hora) é opcional e deve ser informado por inteiro se for utilizado. Caso você opte por não fazer uso dele, a função PHP date se baseará, por padrão, na hora atual re­gis­trada pelo seu sistema.

UNIX Timestamp, também chamado de Posix Time ou Era UNIX, é um inteiro simples que re­pre­senta o número de segundos de­cor­ri­dos desde a data 1º de janeiro de 1970, às 00h00min00 UTC (Tempo Universal Co­or­de­nado). Ele é um dos carimbos de data/hora mais uti­li­za­dos pela ciência da com­pu­ta­ção, por não depender de fusos horários e por pos­si­bi­li­tar a re­a­li­za­ção de cálculos simples com in­for­ma­ções en­vol­vendo horários.

Exemplos de uso da função date em PHP

A função date() é uma poderosa fer­ra­menta para se calcular data em PHP. Ela pode ser combinada com classes PHP, ope­ra­do­res PHP e funções PHP para agir em uma aplicação de forma mais abran­gente.

Con­ca­te­nar data e hora com PHP date

Você pode usar ope­ra­do­res PHP, como o operador de con­ca­te­na­ção, para combinar valores de data e hora com outras strings e variáveis. O exemplo abaixo explica melhor:

$today = date('Y-m-d'); // ano, mês e dia atuais
$message = A data atual é: ' . $today;
echo $message;

Gerar e per­so­na­li­zar ti­mes­tamps com PHP date

Se você pretende gerar um carimbo de data/hora a partir da iden­ti­fi­ca­ção de uma data ou de uma hora por uma string, faça uso de strtotime(), função PHP que executa tal comando. Formate o res­pec­tivo timestamp adi­ci­o­nando ao código função date(), como mostra o exemplo abaixo:

$dateString = '2023-08-19';
$timestamp = strtotime($dateString);
$formattedDate = date('l, F j, Y', $timestamp);
echo $formattedDate;

Assim será o resultado gerado pela execução do código acima, com um timestamp per­so­na­li­zado:

Sábado, 19 agosto, 2023

Classe PHP DateTime

A classe PHP DateTime nada mais é que um método orientado a objetos. Ela é usada para manipular valores de data e hora de forma eficiente, tendo fun­ci­o­na­li­dade se­me­lhante à da função date(). Observe o exemplo de código e entenda melhor as si­mi­la­ri­da­des:

$now = new DateTime();
$formattedDate = $now->format('l, F j, Y H:i:s');
echo $formattedDate;

Perceba que, no exemplo de código, criamos um objeto DateTime chamado $now, que ordena a uti­li­za­ção da data e da hora atuais. Em seguida, usamos o método format() do objeto PHP DateTime para exibir a data e a hora no formato por nós es­ta­be­le­cido. Assim, quando executado, o código retornará a data e a hora no formato pre­vi­a­mente definido.