DateTime do PHP

A partir do PHP 5.2.0, há uma maneira nativa e simples de se trabalhar com horários e datas, com auxílio da classe DateTime .

O objetivo do artigo é mostrar algumas das utilidades da classe DateTime. 

Sumário

1. Construtor da classe

2. Formatando datas

3. Adicionando períodos a datas

4. Subtraindo períodos de uma data

5. Calculando diferença entre datas

6. Modificando a data e a hora do objeto

1. Construtor da classe

Sintaxe do construtor:

DateTime::__construct ([ string $time = "now" [, DateTimeZone $timezone = NULL ]] )

O método aceita dois parâmetros, ambos opcionais. O primeiro é a data/hora, no mesmo formato aceito pela função strftime() . O segundo consiste no timezone que deve ser utilizado. Ele deve ser uma instância da classe DateTimeZone . Uma outra maneira de definir o timezone é por meio da função date_default_timezone_set() .

Ambas as classes DateTime e DateTimeZone disparam uma exceção se seus construtores receberem parâmetro inválidos. Logo, podemos usar blocos try/catch para instanciar essas classes.

try
{
 $DateTime = new DateTime( 'now', new DateTimeZone( 'America/Sao_Paulo') );
}
catch( Exception $e )
{
 echo 'Erro ao instanciar objeto.
';
 echo $e->getMessage();
 exit();
}

Experimente trocar o "now" por um valor não aceito pelo método, como uma string qualquer. Uma exceção será disparada.

2. Formatando datas

Para formatar datas, utilizamos o método format, que aceita um parâmetro, correspondente a uma formatação de data aceita pela função date() .

$DateTime = new DateTime();

echo $DateTime->format( "d/m/Y H:i:s" ) . '
';
echo $DateTime->format( "Y-m-d H:i:s" ) . '
';
echo $DateTime->format( "Y/m/d H:i:s" ) . '
';

 

3. Adicionando períodos a datas

Com o método add(), podemos adicionar períodos à data salva no objeto DateTime. É possível adicionar períodos de dias, períodos de tempo ou ambos, seguindo a formatação aceita pelo método, que recebe um único parâmetro, o qual é uma instância da classeDateInterval , responsável por manipular os dados do período especificado.

Os períodos são especificados da seguinte maneira: períodos de dias são precedidos pela letra "P", seguidas de inteiros e seus respectivos identificadores de tempo ("D" para dias, "M" para meses e "Y" para anos). Períodos de tempo são precedidos pela letra "T" e seguidos de inteiros e seus respectivos identificadores de unidade ("H" para horas, "M" para minutos e "S" para segundos).

$DateTime = new DateTime();

$DateTime->add( new DateInterval( "P30D" ) ); // adiciona 30 dias
echo $DateTime->format( "d/m/Y" ) . '
';


$DateTime->add( new DateInterval( "P2M" ) ); // adiciona 2 meses
echo $DateTime->format( "d/m/Y" ) . '
';


$DateTime->add( new DateInterval( "P5Y" ) ); // adiciona 5 anos
echo $DateTime->format( "d/m/Y" ) . '
';


$DateTime->add( new DateInterval( "P5Y2M30D" ) ); // adiciona 30 dias, 2 meses e 5 anos
echo $DateTime->format( "d/m/Y" ) . '
';

Note que cada adição é feita com base na adição anterior, uma vez que cada soma modifica a data armazenada no objeto.

 

4. Subtraindo períodos de uma data

O método sub funciona da mesma forma que o add, com a mesma lista de parâmetros, mas, logicamente, em vez de adicionar períodos, ele os subtrai.

$DateTime = new DateTime();

$DateTime->sub( new DateInterval( "P30D" ) ); // subtrai 30 dias
echo $DateTime->format( "d/m/Y" ) . '
';


$DateTime->sub( new DateInterval( "P2M" ) ); // subtrai 2 meses
echo $DateTime->format( "d/m/Y" ) . '
';


$DateTime->sub( new DateInterval( "P5Y" ) ); // subtrai 5 anos
echo $DateTime->format( "d/m/Y" ) . '
';


$DateTime->sub( new DateInterval( "P5Y2M30D" ) ); // subtrai 30 dias, 2 meses e 5 anos
echo $DateTime->format( "d/m/Y" ) . '
';

 

5. Calculando diferença entre datas

Usando o método diff, podemos calcular o intervalo entre duas datas, com precisão de dias, meses, anos, horas, minutos e segundos. Esse método retorna uma instância da classe DateInterval, já citada anteriormente neste artigo.

$DateTime = new DateTime();

$diff = $DateTime->diff( new DateTime( '2009-02-14' ) );


echo "Diferença de:

" . $diff->d . " dias

" . $diff->m . " meses

" . $diff->y . " anos

" . $diff->h . " horas

" . $diff->i . " minutos

" . $diff->s . " segundos

";

 

6. Modificando a data e a hora do objeto

Para modificar a data e a hora armazenadas no objeto, utilizamos os métodos setDate esetTime.

$DateTime = new DateTime();

echo $DateTime->format( "d/m/Y H:i" ) . '
';


$DateTime->setDate( 2007, 07, 07 );
$DateTime->setTime( 07, 27 );


echo $DateTime->format( "d/m/Y H:i" ) . '


';

Atenção amigos. Esse artigo não é meu mas sim do Roberto Beraldo Chaiben e o link original é: http://helpmasters.com.br/artigo/92/php-usando-a-classe-nativa-datetime

 Estou reproduzindo pois achei o artigo muito util e assim eu também não perco ele por ai! Todos os créditos ao escritor pelo otimo artigo.