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 dinamicamente, da maneira que você preferir. Ela é especialmente útil para a exibição de datas e horários de publicações, para a configuração de cronômetros de contagens regressiva e para a administração de outras ações relacionadas à contagem de tempo.

O que é PHP date?

PHP date é uma função integrada da linguagem de programação, utilizada para formatar data e hora em sites e aplicações. Ao ser executada, ela retorna uma string que exibe data e hora com a formatação especificada pelos parâmetros previamente 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 informações de um banco de dados MySQL/MariaDB com PHP, a função date() é capaz de exibi-las em um formato legível, recurso especialmente ú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 estruturada da seguinte maneira, para que seja corretamente executada:

date(format, timestamp);

Parâmetros da função date em PHP

Toda função PHP date() deve conter um parâmetro obrigató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 obrigatório, que especifica como a data e a hora devem ser formatadas. Ele contém caracteres específicos, utilizados para orientar o formato a ser exibido:
  • Y: Representa o ano, contendo, portanto, quatro dígitos (por exemplo, 2024).
  • m: Representa o mês do ano em formato numérico, de 01 a 12.
  • d: Representa dia do mês em formato numérico, de 01 a 31.
  • H: Representa a hora no formato de 24 horas, de 00 a 23.
  • i: Representa os minutos, de 00 a 59.
  • s: Representa 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 registrada pelo seu sistema.

UNIX Timestamp, também chamado de Posix Time ou Era UNIX, é um inteiro simples que representa o número de segundos decorridos desde a data 1º de janeiro de 1970, às 00h00min00 UTC (Tempo Universal Coordenado). Ele é um dos carimbos de data/hora mais utilizados pela ciência da computação, por não depender de fusos horários e por possibilitar a realização de cálculos simples com informações envolvendo horários.

Exemplos de uso da função date em PHP

A função date() é uma poderosa ferramenta para se calcular data em PHP. Ela pode ser combinada com classes PHP, operadores PHP e funções PHP para agir em uma aplicação de forma mais abrangente.

Concatenar data e hora com PHP date

Você pode usar operadores PHP, como o operador de concatenaçã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 personalizar timestamps com PHP date

Se você pretende gerar um carimbo de data/hora a partir da identificaçã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 respectivo timestamp adicionando 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 personalizado:

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 funcionalidade semelhante à da função date(). Observe o exemplo de código e entenda melhor as similaridades:

$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 utilizaçã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 estabelecido. Assim, quando executado, o código retornará a data e a hora no formato previamente definido.