zeanwork.com.br  >>  Documentação  >>  Extensions  >>  Date
Date
A extension date ajuda você a trabalhar com datas.


Carregando a extension

Para você utilizar esta extension, você prescisa definir que irá utiliza-lo. Veja mais em: Controllers > Carregando models, components, helpers e extensions.
O nome desta extension é date, este é o nome que você irá utilizar para carrega-lo.


Formatos de datas que o Zeanwork aceita

Valor

Exemplo

br

02/10/2009

dd/mm/aaaa

02/10/2009

dd/mm/aa

02/10/09

dd-mm-aaaa

02-10-2009

dd-mm-aa

02-10-09

eua

2009-10-02

date

2009-10-02

aaaa-mm-dd

2009-10-02

aaaa/mm/dd

2009/10/02

dd/mm/aaaa H:i:s

02/10/2009 09:05:20

dd/mm/aaaa H:i

02/10/2009 09:05

brtime

02/10/2009 09h 05min

dd/mm/aaaa Hh imin

02/10/2009 09h 05min

dd/mm/aaaa H:ih

02/10/2009 09:05h

dd-mm-aaaa H:i:s

02-10-2009 09:05:20

dd-mm-aaaa H:i

02-10-2009 09:05

dd-mm-aaaa Hh imin

02-10-2009 09h 05min

dd-mm-aaaa H:ih

02-10-2009 09:05h

datetime

2009-10-02 09:05:20

aaaa-mm-dd H:i:s

2009-10-02 09:05:20

aaaa-mm-dd H:i

2009-10-02 09:05

aaaa-mm-dd Hh imin

2009-10-02 09h 05min

aaaa-mm-dd H:ih

2009-10-02 09:05h

H:i:s

09:05:20

H:i

09:05

Hh imin

09h 05min

H:ih

09:05h



Convertendo o formato de datas

convert()
Este método converte o formato de uma data.

Parâmetros:
string $date
Data, pode ser em qualquer formato que o Zeanwork reconheça.

string $format [opcional]
Formato a ser convertido.



Retorno:
string
Data convertida.



Veja exemplo:
echo Date::convert('2010-02-14', 'dd/mm/aaaa');



Somando dias em uma data

sum()
Este método soma dias em uma data e retorna uma nova data.

Parâmetros:
string $data
Data inicial.

number $dias
Número de dias a ser somado.



Retorno:
string
Data final, no formato dd/mm/aaaa.



Veja exemplo:
echo Date::sum('2010-02-14', 3);



Diminuindo dias de uma data

min()
Este método diminui dias de uma data e retorna uma nova data.

Parâmetros:
string $data
Data inicial.

number $dias
Número de dias a diminuido.



Retorno:
string
Data final, no formato dd/mm/aaaa.



Veja exemplo:
echo Date::min('2010-02-14', 3);



Dias de um mês

daysInMonth()
Este método retorna a quantia de dias de um determinado mês.

Parâmetros:
number $month
Número do mês.

number $year
Ano.



Retorno:
number
Dias no mês.



Veja exemplo:
echo Date::daysInMonth(2, 2010);



Dias de um ano

daysInYear()
Este método retorna a quantia de dias de um determinado ano.

Parâmetros:
number $year
Ano.



Retorno:
number
Dias no ano.



Veja exemplo:
echo Date::daysInYear(2010);



Diferença de dias entre datas

diff()
Este método retorna a diferença de dias entre duas datas.

Parâmetros:
string $startDate
Data inicial.

string $endDate
Data final.



Retorno:
number
Diferença de dias.



Veja exemplo:
echo Date::diff('20/09/2010', '20/10/2010');



Dia da semana

dayWeeks()
Este método retorna o número do dia da semana a partir de um data.

Parâmetros:
string $date
Data.



Retorno:
number
Número do dia da semana. Ex: quarta-feira = 4, quinta-feira = 5...



Veja exemplo:
echo Date::dayWeeks('20/09/2010');



Calendário

calendar()
Este método retorna uma matriz como um calendário.

Parâmetros:
number $month
Número do mês.

number $year
Ano.



Retorno:
array
Matriz com o calendário.



Veja exemplo:
echo Date::dayWeeks('20/09/2010');