PHP Coupé

Aprendendo

Classes

Coupe_Datetime

Funções para manipulação de dados em formato data.

Validando

Type

Verifica o formato da data enviada.
OBS: pode-se utilizar a classe 'Validate' para o mesmo propósito.

Recebe: ($string=data)
Retorna: FALSE (caso nao seja validado) ou STRING (tipo do formato)

...
$Coupe->import('Timedate');
// recebe 'eu'
$formato =  $Coupe->Timedate->type('29/01/2009');
// recebe 'us'
$formato =  $Coupe->Timedate->type('01/29/2009');
// recebe 'unix'
$formato =  $Coupe->Timedate->type('2009/01/29');
...

Calculando

Interval

Calcula o intervalo entre duas datas.
Se a segunda data não for informada, será usada a data atual.
E se o terceiro parametro não for informado, será calculada a diferença em dias.

Recebe: ($string=data1, [$string=data2], [$string=day | month | year | full])
Retorna: STRING (diferenca entre uma data e outra em horas, dias, meses, anos)

...
$Coupe->import('Timedate');
// retorna '31'
return $Coupe->Timedate->interval('01/01/2009', '01/02/2009');
...

Days in Month

Função que retorna quantos dias determinado mês possui.
Serve também para dizer se o ano indicado foi bissesto.
Se não for indicado o ano, o ano atual será utilizado.
Pode-se utilizar date("t", mktime(0, 0, 0, m, d, Y));.

Recebe: ($int=mes, [$int=ano])
Retorna: INT (quantidade de dias)

...
$Coupe->import('Timedate');
// retorna '28' por que 2010 eh ano bissesto
return $Coupe->Timedate->daysInMonth(02, 2010);
...

Increase

Função para somar dias a determinada data.
Passe-se uma data (ou string vazia), e a quantidade de dias, meses, ou anos que se quer somar.
Se a data passada for uma string vazia, a data atual será utilizada na operação.

Recebe: ($string=d/m/Y|'', [int=dia], [int=mes], [int=ano])
Retorna: STRING (data em formato europeu)

...
$Coupe->import('Timedate');
// soma 2 dias e retorna '03/01/2006'
return $Coupe->Timedate->increase('01/01/2006', 2);
...

Decrease

Função para subtrair dias a determinada data.
Passe-se uma data no formato europeu (ou string vazia), e a quantidade de dias, meses, ou anos que se quer subtrair.
Se a data passada for uma string vazia, a data atual será utilizada na operação.

Recebe: ($string=d/m/Y|'', [int=dia], [int=mes], [int=ano])
Retorna: STRING (data em formato europeu)

...
$Coupe->import('Timedate');
// subtrai 2 dias e retorna '01/01/2006'
return $Coupe->Timedate->decrease('03/01/2006', 2);
...

Timezone

Retorna a diferença de hora local de acordo com o meridiano de Greenwich.

Recebe: ($string=codigo_local)
Retorna: STRING (diferença em horas em relação ao meridiano de Greenwich)

...
$Coupe->import('Timedate');
// retorna 3 (sendo essa a diferenca em horas em relacao a UTC)
return $Coupe->Timedate->timezone('UP3');
...