date

date -- Formata a data e a hora local

Descrição

string date ( string format [, int timestamp])

Retorna uma string de acordo com o formato da string usando o inteiro dado timestamp ou a a hora corrente local se nenhum timestamp é dado .

Nota : A linha válida de um timestamp é tipicamente de Fri , 13 Dec 1901 20:45:54 GMT to Tue , 19 Jan 2038 03:14:07 GMT . ( Estas são as datas que correspodem aos mínimos e máximos valores para um inteiro de 32-bit definido ) . No windows esta linha é limitada de 01-01-1970 para 19-01-2038 .

Para gerar um timestamp de uma string para representação de data , você deve estar capaz de usar strtotime( ) . Adicionalmente , alguns bancos de dados têm para converter suas datas em timestamps ( tais como a função MySQL's UNIX_TIMESTAMP ) .



Os seguintes caracteres são reconhecidos na estrutura da string :

Caracteres irreconhecíveis na forma de string serão impressas como são. O "Z" formato poderá sempre retornar "0" quando usar gmdate() .

Exemplo 1 . date( ) exemplo

 
echo

 
date

 
(

 
"l

 
dS

 
of

 
F

 
Y

 
h:i:s

 
A")

 
;

 
echo

 
"July

 
1

 
,

 
2000

 
is

 
on

 
a

 
"

 
.

 
date

 
("l"

 
,

 
mktime(0,0,0,7,1,2000))

 
;





Você pode prevenir um caracter conhecido no formato de string de um existente por escape com uma barra invertida precedendo-o . Se o caracter com a barra invertida é uma sequência especial , você pode precisar também de escape para a barra invertida .

Exemplo 2 . Caracteres de escape em date( )

 
echo

 
date(

 
"l

 
\\t\h\e

 
jS")

 
;

 
/

 
/

 
prints

 
something

 
like

 
'Saturday

 
the

 
8th

 
'





é possível usar date( ) e mktime( ) juntos para encontrar datas no futuro ou no passado .

Exemplo 3 . date( ) e mktime( ) exemplo

 
$tomorrow

 
=

 
mktime

 
(

 
0,0,0,date("m"

 
)

 
,date("d")+1,date("Y"))

 
;

 
$lastmonth

 
=

 
mktime

 
(0,0,0,date("m")-1,date("d")

 
,

 
date("Y"))

 
;

 
$nextyear

 
=

 
mktime

 
(0,0,0,date("m")

 
,

 
date("d")

 
,

 
date("Y")+1)

 
;



Nota : Esta pode ser mais confiável do que simplesmente adicionar ou subtrair o número de segundos em um dia ou mês para um timestamp devido ao horário de verão .



Alguns exemplos de date( ) Alguns exemplos de date( ) formatação . Note que você poderia escapar qualquer outro caracter , qualquer um que correntemente tenha um significado especial produziria resultados indesejáveis , e outros caracteres poderiam assumir significados em futuras versões do PHP . Quando usar escape , certifique o uso de aspas simples para evitar caracteres como \n próprio para novas linhas .

Exemplo 4 . date( ) Formatação

 
/*

 
Today

 
is

 
March

 
10th

 
,

 
2001

 
,

 
5:16:18

 
pm

 
*

 
/

 
$today

 
=

 
date(

 
"F

 
j

 
,

 
Y

 
,

 
g:i

 
a")

 
;

 
/

 
/

 
March

 
10

 
,

 
2001

 
,

 
5:16

 
pm

 
$today

 
=

 
date("m.d.y")

 
;

 
/

 
/

 
03.10.01

 
$today

 
=

 
date("j

 
,

 
n

 
,

 
Y")

 
;

 
/

 
/

 
10

 
,

 
3

 
,

 
2001

 
$today

 
=

 
date("Ymd")

 
;

 
/

 
/

 
20010310

 
$today

 
=

 
date('h-i-s

 
,

 
j-m-y

 
,

 
it

 
is

 
w

 
Day

 
z

 
')

 
;

 
/

 
/

 
05-16-17

 
,

 
10-03-01

 
,

 
1631 1618 6

 
Fripm01

 
$today

 
=

 
date('\i\t

 
\i\s

 
\t\h\e

 
jS

 
\d\a\y

 
.')

 
;

 
/

 
/

 
It

 
is

 
the

 
10th

 
day

 
.

 
$today

 
=

 
date("D

 
M

 
j

 
G:i:s

 
T

 
Y")

 
;

 
/

 
/

 
Sat

 
Mar

 
10 15:16:08

 
MST

 
2001

 
$today

 
=

 
date('H:m:s

 
\m

 
\i\s\

 
\m\o\n\t\h')

 
;

 
/

 
/

 
17:03:17

 
m

 
is

 
month

 
$today

 
=

 
date("H:i:s")

 
;

 
/

 
/

 
17:16:17





Para formatar datas em outras línguas , você usaria as funções setlocale( ) e strftime( ) .

Veja também getlastmod( ) , gmdate( ) , mktime( ) , strftime( ) e time( ) .