<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >date</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" TITLE="Manual do PHP" HREF="index.html"><LINK REL="UP" TITLE="Data e hora" HREF="ref.datetime.html"><LINK REL="PREVIOUS" TITLE="date_timezone_set" HREF="function.date-timezone-set.html"><LINK REL="NEXT" TITLE="getdate" HREF="function.getdate.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=UTF-8"></HEAD ><BODY CLASS="refentry" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >Manual do PHP</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.date-timezone-set.html" ACCESSKEY="P" >Anterior</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.getdate.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.date" ></A >date</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN26190" ></A ><P > (PHP 3, PHP 4, PHP 5)</P >date -- Formata a data e a hora local</DIV ><DIV CLASS="refsect1" ><A NAME="AEN26193" ></A ><H2 >Descrição</H2 >string <B CLASS="methodname" >date</B > ( string format [, int timestamp] )<BR ></BR ><P > Retorna uma string de acordo com a string format dada usando o inteiro <CODE CLASS="parameter" >timestamp</CODE > dado ou a hora atual local se nenhum timestamp é dado. Em outras palavras, <CODE CLASS="parameter" >timestamp</CODE > é opcional e o padrão para o valor de <A HREF="function.time.html" ><B CLASS="function" >time()</B ></A >. <DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > 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. </P ></BLOCKQUOTE ></DIV > <DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > Para gerar um timestamp a partir de uma representação de string da data, você deve ser capaz de usar <A HREF="function.strtotime.html" ><B CLASS="function" >strtotime()</B ></A >. Adicionalmente, alguns bancos de dados têm funções para converter suas datas em timestamps (tais como a função do MySQL <A HREF="http://dev.mysql.com/doc/mysql/en/date-and-time-functions.html" TARGET="_top" >UNIX_TIMESTAMP</A >). </P ></BLOCKQUOTE ></DIV > </P ><P > <DIV CLASS="table" ><A NAME="AEN26215" ></A ><P ><B >Tabela 1. Os seguintes caracteres são reconhecidos no <CODE CLASS="parameter" >format</CODE > parameter string</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><COL><COL><COL><THEAD ><TR ><TH ><CODE CLASS="parameter" >format</CODE > character</TH ><TH >Descrição</TH ><TH >Exemplo de valores retornados</TH ></TR ></THEAD ><TBODY ><TR ><TD ><TT CLASS="literal" >a</TT ></TD ><TD >Lowercase Ante meridiem and Post meridiem</TD ><TD ><TT CLASS="literal" >am</TT > or <TT CLASS="literal" >pm</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >A</TT ></TD ><TD >Uppercase Ante meridiem and Post meridiem</TD ><TD ><TT CLASS="literal" >AM</TT > ou <TT CLASS="literal" >PM</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >B</TT ></TD ><TD >Swatch Internet time</TD ><TD ><TT CLASS="literal" >000</TT > até <TT CLASS="literal" >999</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >d</TT ></TD ><TD >Dia do mês, 2 digitos com leading zeros</TD ><TD ><TT CLASS="literal" >01</TT > to <TT CLASS="literal" >31</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >D</TT ></TD ><TD >Uma representação textual de um dia, três letras</TD ><TD ><TT CLASS="literal" >Mon</TT > through <TT CLASS="literal" >Sun</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >F</TT ></TD ><TD >Uma representação textual de um mês, tal como janeiro ou Março</TD ><TD ><TT CLASS="literal" >Janeiro</TT > a <TT CLASS="literal" >Dezembro</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >g</TT ></TD ><TD >12-hour formato de hora sem leading zeros</TD ><TD ><TT CLASS="literal" >1</TT > a <TT CLASS="literal" >12</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >G</TT ></TD ><TD >24-hour formato de hora sem leading zeros</TD ><TD ><TT CLASS="literal" >0</TT > a <TT CLASS="literal" >23</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >h</TT ></TD ><TD >12-hour formato de hora com leading zeros</TD ><TD ><TT CLASS="literal" >01</TT > a <TT CLASS="literal" >12</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >H</TT ></TD ><TD >24-hour formato de hora com leading zeros</TD ><TD ><TT CLASS="literal" >00</TT > a <TT CLASS="literal" >23</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >i</TT ></TD ><TD >Minutos com leading zeros</TD ><TD ><TT CLASS="literal" >00</TT > para <TT CLASS="literal" >59</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >I</TT > (i maiúsculo)</TD ><TD >Se a data está ou não em horário de verão</TD ><TD ><TT CLASS="literal" >1</TT > Horário de Verão, <TT CLASS="literal" >0</TT > sem Horário de Verão.</TD ></TR ><TR ><TD ><TT CLASS="literal" >j</TT ></TD ><TD >Dia do mês sem leading zeros</TD ><TD ><TT CLASS="literal" >1</TT > to <TT CLASS="literal" >31</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >l</TT > ('L' minúsculo)</TD ><TD >Uma representação completa textual de um dia da semana</TD ><TD ><TT CLASS="literal" >Domingo</TT > a <TT CLASS="literal" >Sábado</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >L</TT ></TD ><TD >Se é ano bissexto</TD ><TD ><TT CLASS="literal" >1</TT > ano bissexto, <TT CLASS="literal" >0</TT > ano não bissexto.</TD ></TR ><TR ><TD ><TT CLASS="literal" >m</TT ></TD ><TD >Representação numérica de um mês, com leading zeros</TD ><TD ><TT CLASS="literal" >01</TT > a <TT CLASS="literal" >12</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >M</TT ></TD ><TD >Uma representação textual curta de um mês, três letras</TD ><TD ><TT CLASS="literal" >Jan</TT > a <TT CLASS="literal" >Dec</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >n</TT ></TD ><TD >Representação numérica de um mês, sem leading zeros</TD ><TD ><TT CLASS="literal" >1</TT > a <TT CLASS="literal" >12</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >O</TT ></TD ><TD >Diferença ao horário de Greenwich (GMT) em horas</TD ><TD >Exemplo: <TT CLASS="literal" >+0200</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >r</TT ></TD ><TD ><A HREF="http://www.faqs.org/rfcs/rfc2822" TARGET="_top" >RFC 2822</A > formatted date</TD ><TD >Exemplo: <TT CLASS="literal" >Thu, 21 Dec 2000 16:01:07 +0200</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >s</TT ></TD ><TD >Segundos, com leading zeros</TD ><TD ><TT CLASS="literal" >00</TT > a <TT CLASS="literal" >59</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >S</TT ></TD ><TD >Sufixo ordinal inglês para o dia do mês, 2 caracteres</TD ><TD > <TT CLASS="literal" >st</TT >, <TT CLASS="literal" >nd</TT >, <TT CLASS="literal" >rd</TT > ou <TT CLASS="literal" >th</TT >. Funciona bem com <TT CLASS="literal" >j</TT > </TD ></TR ><TR ><TD ><TT CLASS="literal" >t</TT ></TD ><TD >Número de dias do dado mês</TD ><TD ><TT CLASS="literal" >28</TT > a <TT CLASS="literal" >31</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >T</TT ></TD ><TD >Timezone setting of this machine</TD ><TD >Examples: <TT CLASS="literal" >EST</TT >, <TT CLASS="literal" >MDT</TT > ...</TD ></TR ><TR ><TD ><TT CLASS="literal" >U</TT ></TD ><TD >Seconds since the Unix Epoch (January 1 1970 00:00:00 GMT)</TD ><TD >See also <A HREF="function.time.html" ><B CLASS="function" >time()</B ></A ></TD ></TR ><TR ><TD ><TT CLASS="literal" >w</TT ></TD ><TD >Representação numérica do dia da semana</TD ><TD ><TT CLASS="literal" >0</TT > (para Domingo) a <TT CLASS="literal" >6</TT > (para Sábado)</TD ></TR ><TR ><TD ><TT CLASS="literal" >W</TT ></TD ><TD >Número da semana do ano ISO-8601, semanas começadas na segunda-feira (adicionado no PHP 4.1.0)</TD ><TD >Exemplo: <TT CLASS="literal" >42</TT > (a 42nd (quadragésima segunda) semana do ano)</TD ></TR ><TR ><TD ><TT CLASS="literal" >Y</TT ></TD ><TD >Uma representação completa do ano, 4 dígitos</TD ><TD >Examples: <TT CLASS="literal" >1999</TT > ou <TT CLASS="literal" >2003</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >y</TT ></TD ><TD >Representação do ano em dois dígitos</TD ><TD >Examples: <TT CLASS="literal" >99</TT > ou <TT CLASS="literal" >03</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >z</TT ></TD ><TD >O dia do ano (começando de 0)</TD ><TD ><TT CLASS="literal" >0</TT > a <TT CLASS="literal" >365</TT ></TD ></TR ><TR ><TD ><TT CLASS="literal" >Z</TT ></TD ><TD >Timezone offset in seconds. The offset for timezones west of UTC is always negative, and for those east of UTC is always positive.</TD ><TD ><TT CLASS="literal" >-43200</TT > até <TT CLASS="literal" >43200</TT ></TD ></TR ></TBODY ></TABLE ></DIV > </P ><P > Caracteres não reconhecidos no formato de serão impressos como são. O formato <TT CLASS="literal" >Z</TT > será sempre retornado <TT CLASS="literal" >0</TT > quando usar <A HREF="function.gmdate.html" ><B CLASS="function" >gmdate()</B ></A >. </P ><P > <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN26448" ></A ><P ><B >Exemplo 1. <B CLASS="function" >date()</B > exemplos</B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br /></font><font color="#FF8000">// Prints something like: Wednesday<br /></font><font color="#007700">echo </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"l"</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// Prints something like: Wednesday 15th of January 2003 05:51:38 AM<br /></font><font color="#007700">echo </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"l dS of F Y h:i:s A"</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// Prints: July 1, 2000 is on a Saturday<br /></font><font color="#007700">echo </font><font color="#DD0000">"July 1, 2000 is on a " </font><font color="#007700">. </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"l"</font><font color="#007700">, </font><font color="#0000BB">mktime</font><font color="#007700">(</font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">7</font><font color="#007700">, </font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">2000</font><font color="#007700">));<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > </P ><P > Você pode prevenir um caracter conhecido no formato de string de um existente escapando-o com uma barra invertida antes dele. Se o caracter com a barra invertida já é uma sequência especial, você pode precisar também escapar a barra invertida. <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN26453" ></A ><P ><B >Exemplo 2. Caracteres de escape em <B CLASS="function" >date()</B ></B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br /></font><font color="#FF8000">// exibe algo como: Wednesday the 15th<br /></font><font color="#007700">echo </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"l \\t\h\e jS"</font><font color="#007700">);<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > </P ><P > É possível utilizar <B CLASS="function" >date()</B > e <A HREF="function.mktime.html" ><B CLASS="function" >mktime()</B ></A > juntos para encontrar datas no futuro ou no passado. <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN26460" ></A ><P ><B >Exemplo 3. <B CLASS="function" >date()</B > e <A HREF="function.mktime.html" ><B CLASS="function" >mktime()</B ></A > exemplo </B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br />$tomorrow </font><font color="#007700">= </font><font color="#0000BB">mktime </font><font color="#007700">(</font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"m"</font><font color="#007700">) , </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"d"</font><font color="#007700">)+</font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"Y"</font><font color="#007700">));<br /></font><font color="#0000BB">$lastmonth </font><font color="#007700">= </font><font color="#0000BB">mktime </font><font color="#007700">(</font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"m"</font><font color="#007700">)-</font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"d"</font><font color="#007700">), </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"Y"</font><font color="#007700">));<br /></font><font color="#0000BB">$nextyear </font><font color="#007700">= </font><font color="#0000BB">mktime </font><font color="#007700">(</font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"m"</font><font color="#007700">), </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"d"</font><font color="#007700">), </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"Y"</font><font color="#007700">)+</font><font color="#0000BB">1</font><font color="#007700">);<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > <DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > 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. </P ></BLOCKQUOTE ></DIV > </P ><P > Alguns exemplos de formatação de <B CLASS="function" >date()</B >. Note que você poderia escapar qualquer outro caracter, como algum que atualmente tenha um significado especial produzirá 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. <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN26469" ></A ><P ><B >Exemplo 4. Formatação de <B CLASS="function" >date()</B > </B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br /></font><font color="#FF8000">// Assumindo que hoje é: March 10th, 2001, 5:16:18 pm<br /><br /></font><font color="#0000BB">$today </font><font color="#007700">= </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"F j, Y, g:i a"</font><font color="#007700">); </font><font color="#FF8000">// March 10, 2001, 5:16 pm<br /></font><font color="#0000BB">$today </font><font color="#007700">= </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"m.d.y"</font><font color="#007700">); </font><font color="#FF8000">// 03.10.01<br /></font><font color="#0000BB">$today </font><font color="#007700">= </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"j, n, Y"</font><font color="#007700">); </font><font color="#FF8000">// 10, 3, 2001<br /></font><font color="#0000BB">$today </font><font color="#007700">= </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"Ymd"</font><font color="#007700">); </font><font color="#FF8000">// 20010310<br /></font><font color="#0000BB">$today </font><font color="#007700">= </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">'h-i-s, j-m-y, it is w Day z '</font><font color="#007700">); </font><font color="#FF8000">// 05-16-17, 10-03-01, 1631 1618 6 Fripm01<br /></font><font color="#0000BB">$today </font><font color="#007700">= </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">'\i\t \i\s \t\h\e jS \d\a\y.'</font><font color="#007700">); </font><font color="#FF8000">// It is the 10th day.<br /></font><font color="#0000BB">$today </font><font color="#007700">= </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"D M j G:i:s T Y"</font><font color="#007700">); </font><font color="#FF8000">// Sat Mar 10 15:16:08 MST 2001<br /></font><font color="#0000BB">$today </font><font color="#007700">= </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">'H:m:s \m \i\s\ \m\o\n\t\h'</font><font color="#007700">); </font><font color="#FF8000">// 17:03:17 m is month<br /></font><font color="#0000BB">$today </font><font color="#007700">= </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"H:i:s"</font><font color="#007700">); </font><font color="#FF8000">// 17:16:17<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > </P ><P > Para formatar datas em outras línguas, você usaria as funções <A HREF="function.setlocale.html" ><B CLASS="function" >setlocale()</B ></A > e <A HREF="function.strftime.html" ><B CLASS="function" >strftime()</B ></A > functions. </P ><P > Veja também <A HREF="function.getlastmod.html" ><B CLASS="function" >getlastmod()</B ></A >, <A HREF="function.gmdate.html" ><B CLASS="function" >gmdate()</B ></A >, <A HREF="function.mktime.html" ><B CLASS="function" >mktime()</B ></A >, <A HREF="function.strftime.html" ><B CLASS="function" >strftime()</B ></A > e <A HREF="function.time.html" ><B CLASS="function" >time()</B ></A >. </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.date-timezone-set.html" ACCESSKEY="P" >Anterior</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Principal</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.getdate.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >date_timezone_set</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.datetime.html" ACCESSKEY="U" >Acima</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >getdate</TD ></TR ></TABLE ></DIV ></BODY ></HTML >