Como formatar Data e Hora em PHP

Vamos ver como formatar data e hora em PHP de forma objetiva e abordando os tópicos mais recorrentes. Data e hora são uma constante na vida dos programadores e quase sempre surgem dúvidas quanto a sua utilização.

O assunto é extenso e possui muitos detalhes, portanto, neste artigo, apresentarei os primeiros passos de maneira clara e direta.

Use a função date( ) para formatar Data e hora

A função date( ) é a responsável por formatar data e hora em php. Esta função retorna uma string que representa a data e hora, de acordo com os valores passados para os seus parâmetros. Abaixo, a estrutura da função:

string date ( string $format [, int $timestamp ] )

Analisando sua estrutura, a variável $format receberá o formato de saída da data e $timestamp, que é opcional, receberá o timestamp Unix da data e hora que se deseja exibir. Caso, este valor não seja fornecido, o timestamp Unix atual será padronizado pelo PHP. Vamos ver alguns exemplos de utilização da função date( ):

// Considerando que hoje é 07 de agosto de 2011, 06:23:25 pm

echo date("d.m.y");             // 07.08.11
echo date("j, n, Y");           // 7, 8, 2011
echo date("dmY");               // 07082011
echo date("d/m/Y H:i:s");       // 07/08/2011 18:23:25
echo date("Y-m-d H:i:s");       // 2011-08-07 18:23:25
echo date("w");                 // 0 (dia da semana - 0 domingo a 6 sábado)
echo date("W");                 // 31 (número da semana do ano 1 a 52/53)
echo date("z");	              // 218 (dia do ano 0 a 364)
echo date("U");                 // 1291753405 (timestamp)
echo date("l F j, Y, g:i a");   // Sunday August 7, 2011, 6:23 pm
echo date("D M j G:i:s Y");     // Sun Aug 7 18:23:25 2011
echo date('\H\o\j\e \é \d\i\a j \d\e F \d\e Y');// Hoje é dia 7 de August de 2011
echo date('\A\g\o\r\a \s\ã\o H\h i\m\i\n s\s'); // Agora são 18h 23min 25s
echo date('\H\o\j\e \é \o jS \d\i\a');          // Hoje é o 7th dia
echo date('Hoje é o jS dia'); //1920117America/Sao_Paulo é 2011 7th 0708pm

Dicas importantes sobre a função date( )

1ª ) Como os nomes dos dias da semana e dos meses são representados em inglês com esta função, geralmente ela é mais utilizada quando se quer representar a data e hora sem a presença do nome do mês ou do nome do dia da semana;

2ª ) No código acima, especificamente no último exemplo, você pôde perceber o resultado indesejável ocasionado pela não utilização do caractere de escape (\). Portanto, ao utilizar caracteres que possam conflitar com os parâmetros de formatação, utilize escape. Além disso, em vez de utilizar aspas duplas utilize aspas simples para prevenir que caracteres como \n sejam interpretados como nova linha;

3ª ) Você deve estar se perguntando: como formatar datas em português? Para formatar datas em outras línguas, devemos usar as funções setlocale() e strftime() em vez de date(). O tutorial Como formatar Data e Hora em PHP com setlocale e strftime trata justamente disso.

Muito obrigado pelo seu voto de confiança no blog e no conteúdo. Espero que o tutorial tenha sido proveitoso.

Deixe seu comentário e inscreva-se no Feed RSS do Scriptmaster.

Abraço e até o próximo tutorial.