Sophie

Sophie

distrib > Mandriva > 2008.1 > i586 > by-pkgid > 703d980c580707c382b4e43e25965bc5 > files > 9898

php-manual-pt_BR-5.2.4-1mdv2008.1.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>strftime</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="mktime"
HREF="function.mktime.html"><LINK
REL="NEXT"
TITLE="strptime"
HREF="function.strptime.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.mktime.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.strptime.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.strftime"
></A
>strftime</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN27018"
></A
><P
>    (PHP 3, PHP 4, PHP 5)</P
>strftime&nbsp;--&nbsp;
     Formata uma hora/data de acordo com as configurações locais
    </DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN27021"
></A
><H2
>Descrição</H2
>string <B
CLASS="methodname"
>strftime</B
> ( string format [, int timestamp] )<BR
></BR
><P
>&#13;     Retorna uma string formatada de acordo com o 
	 formato dado em <CODE
CLASS="parameter"
>timestamp</CODE
> ou o horário corrente
	 se nenhum timestamp é dado. Nomes de mês e dia da semana e
     outras strings dependentes de linguagens respeitam o a localidade definida com <A
HREF="function.setlocale.html"
><B
CLASS="function"
>setlocale()</B
></A
>.
    </P
><P
>&#13;     As seguintes conversões especificadoras são conhecidas no formato de string:
     <P
></P
><UL
><LI
><P
>&#13;        %a - dia da semana abreviado de acordo com a localidade
       </P
></LI
><LI
><P
>&#13;        %A - nome da semana completo de acordo com a localidade
       </P
></LI
><LI
><P
>&#13;        %b - nome do mês abreviado de acordo com a localidade 
       </P
></LI
><LI
><P
>&#13;        %B - nome do mês completo de acordo com a localidade
       </P
></LI
><LI
><P
>&#13;        %c - representação da data e hora preferida pela a localidade
       </P
></LI
><LI
><P
>&#13;        %C - número do século (o ano dividido por 100 e truncado para
        um inteiro, de 00 até 99)
       </P
></LI
><LI
><P
>&#13;        %d - dia do mês como um número decimal (de 01 até 31)
       </P
></LI
><LI
><P
>&#13;        %D - mesmo que %m/%d/%y
       </P
></LI
><LI
><P
>&#13;        %e - dia do mês como um número decimal, um simples dígito é
        precedido por espaço (de ' 1' até '31')
       </P
></LI
><LI
><P
>&#13;        %g - como %G, mas sem o século.
       </P
></LI
><LI
><P
>&#13;        %G - o  4-dígito do ano correspodendo as  ISO week number (see %V).
        Este tem o mesmo formato e valor que %Y, exceto que se o ISO week
        number pertence ao prévio ou próximo ano, aquele ano é usado
        ao invés deste.
       </P
></LI
><LI
><P
>&#13;        %h - mesmo que %b
       </P
></LI
><LI
><P
>&#13;        %H - hora como um número decimal usando um relógio de 24-horas (de 00
        até 23)
       </P
></LI
><LI
><P
>&#13;        %I - hora como um número decimal usando um relógio de 12-hoas (de 01
        até 12)
       </P
></LI
><LI
><P
>&#13;        %j - dia do ano como número decimal (de 001 até 366)
       </P
></LI
><LI
><P
>&#13;        %m - mês como número decimal (de 01 até 12)
       </P
></LI
><LI
><P
>&#13;        %M - minuto como número decimal
       </P
></LI
><LI
><P
>&#13;        %n - caracter novalinha
       </P
></LI
><LI
><P
>&#13;        %p - um dos dois `am' ou `pm' de acordo com o valor da hora dada, ou
		as strings correspondentes para a localidade
       </P
></LI
><LI
><P
>&#13;        %r - hora em a.m. e p.m. notação
       </P
></LI
><LI
><P
>&#13;        %R - hora em notação de 24 horas
       </P
></LI
><LI
><P
>&#13;        %S - segundo como um número decimal
       </P
></LI
><LI
><P
>&#13;        %t - caracter tab
       </P
></LI
><LI
><P
>&#13;        %T - hora corrente, igual a %H:%M:%S
       </P
></LI
><LI
><P
>&#13;        %u - dia da semana como número decimal [1,7], com 1 representando
        Segunda-feira
       </P
><DIV
CLASS="warning"
><P
></P
><TABLE
CLASS="warning"
BORDER="1"
WIDTH="100%"
><TR
><TD
ALIGN="CENTER"
><B
>Atenção</B
></TD
></TR
><TR
><TD
ALIGN="LEFT"
><P
>&#13;         Sun Solaris parece iniciar o Domingo como 1
         embora ISO 9889:1999 (o padrão C corrente) claramente
         especificados que  ele poderia ser segunda-feira.
        </P
></TD
></TR
></TABLE
></DIV
></LI
><LI
><P
>&#13;        %U - dia da semana do ano corrente como número decimal,
        começando com o primeiro domingo como o primeiro dia da primeira semana
       </P
></LI
><LI
><P
> 
         %V - O número da semana corrente ISO 8601:1988  do ano corrente como um 
        número decimal, de 01 até 53, onde semana 1 é a primeira semana que tem pelo 
		menos 4 dias no ano corrente, e com
        segunda-feira como o primeiro dia da semana. (Use %G ou %g para o componente
        anual que corresponde ao dia da semana para o para o timestamp especificado.)
       </P
></LI
><LI
><P
>&#13;         %W - dia da semana do ano corrente como número decimal,
        começando com o a segunda-feira como o primeiro dia da primera semana
       </P
></LI
><LI
><P
>&#13;        %w - dia da semana como número decimal, domingo sendo 0
       </P
></LI
><LI
><P
>&#13;        %x - representação preferida para a data para a localidade corrente 
        sem a hora
       </P
></LI
><LI
><P
>&#13;        %X - representação preferida para a hora para a localidade corrente 
        sem a data
       </P
></LI
><LI
><P
>&#13;        %y - ano como número decimal sem o século (de 00 até
        99)
       </P
></LI
><LI
><P
>&#13;         %Y - ano como número decimal incluindo o século
       </P
></LI
><LI
><P
>&#13;        %Z - time zone ou nome or abreviação
       </P
></LI
><LI
><P
>&#13;        %% - a literal `%' character
       </P
></LI
></UL
>
     <DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
       Note que todas as conversões especificadas podem ser suportadas
	   pela sua biblioteca C, em alguns casos elas não serão suportadas
	   pelo PHP  <B
CLASS="function"
>strftime()</B
>. Além disso, nem todas as
	    plataformas suportam timestamps negativos, então sua faixa de datas 
	    não pode ser limitada mais cedo do que a época Unix. Isto significa 
       e.g. %e, %T, %R e %D (e outras mais) e datas anteriores a
       <TT
CLASS="literal"
>Jan 1, 1970</TT
> não funcionarão em Windows, algumas 
       distribuições Linux, e alguns outros sistemas operacionais. Para sistemas
        Windows um resumo completo dos especificadores de conversão suportados
          podem ser encontrados neste website
       <A
HREF="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vclib/html/_crt_strftime.2c_.wcsftime.asp"
TARGET="_top"
><ACRONYM
CLASS="acronym"
>MSDN</ACRONYM
> </A
>.
      </P
></BLOCKQUOTE
></DIV
>
     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN27115"
></A
><P
><B
>Exemplo 1. <B
CLASS="function"
>strftime()</B
> exemplos locais</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />setlocale</font><font color="#007700">(</font><font color="#0000BB">LC_TIME</font><font color="#007700">, </font><font color="#DD0000">"C"</font><font color="#007700">);<br />echo </font><font color="#0000BB">strftime</font><font color="#007700">(</font><font color="#DD0000">"%A"</font><font color="#007700">);<br /></font><font color="#0000BB">setlocale</font><font color="#007700">(</font><font color="#0000BB">LC_TIME</font><font color="#007700">, </font><font color="#DD0000">"fi_FI"</font><font color="#007700">);<br />echo </font><font color="#0000BB">strftime</font><font color="#007700">(</font><font color="#DD0000">" in Finnish is %A,"</font><font color="#007700">);<br /></font><font color="#0000BB">setlocale</font><font color="#007700">(</font><font color="#0000BB">LC_TIME</font><font color="#007700">, </font><font color="#DD0000">"fr_FR"</font><font color="#007700">);<br />echo </font><font color="#0000BB">strftime</font><font color="#007700">(</font><font color="#DD0000">" in French %A and"</font><font color="#007700">);<br /></font><font color="#0000BB">setlocale</font><font color="#007700">(</font><font color="#0000BB">LC_TIME</font><font color="#007700">, </font><font color="#DD0000">"de_DE"</font><font color="#007700">);<br />echo </font><font color="#0000BB">strftime</font><font color="#007700">(</font><font color="#DD0000">" in German %A.\n"</font><font color="#007700">);<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
     Este exemplo trabalha se você tiver as  respectivas 
	 localidades instaladas em seu sistema.
     <DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
       %G e %V, que são baseadas nos números de semana no ISO 8601:1988 
	   pode ser dado resultados inesperados (embora corretos) se o sistema numérico não é perfeitamente entendido. Veja %V e o exemplo abaixo.
      </P
></BLOCKQUOTE
></DIV
>
     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN27121"
></A
><P
><B
>Exemplo 2. Exemplo de número de semana ISO 8601:1988 </B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /></font><font color="#FF8000">/*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;December 2002 / January 2003<br />ISOWk&nbsp;&nbsp;M&nbsp;&nbsp;&nbsp;Tu&nbsp;&nbsp;W&nbsp;&nbsp;&nbsp;Thu F&nbsp;&nbsp;&nbsp;Sa&nbsp;&nbsp;Su<br />----- ----------------------------<br />51&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;16&nbsp;&nbsp;17&nbsp;&nbsp;18&nbsp;&nbsp;19&nbsp;&nbsp;20&nbsp;&nbsp;21&nbsp;&nbsp;22 <br />52&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;23&nbsp;&nbsp;24&nbsp;&nbsp;25&nbsp;&nbsp;26&nbsp;&nbsp;27&nbsp;&nbsp;28&nbsp;&nbsp;29<br />1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;30&nbsp;&nbsp;31&nbsp;&nbsp;&nbsp;1&nbsp;&nbsp;&nbsp;2&nbsp;&nbsp;&nbsp;3&nbsp;&nbsp;&nbsp;4&nbsp;&nbsp;&nbsp;5<br />2&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;6&nbsp;&nbsp;&nbsp;7&nbsp;&nbsp;&nbsp;8&nbsp;&nbsp;&nbsp;9&nbsp;&nbsp;10&nbsp;&nbsp;11&nbsp;&nbsp;12<br />3&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;13&nbsp;&nbsp;14&nbsp;&nbsp;15&nbsp;&nbsp;16&nbsp;&nbsp;17&nbsp;&nbsp;18&nbsp;&nbsp;19&nbsp;&nbsp;&nbsp;*/<br /><br />// Outputs: 12/28/2002 - %V,%G,%Y = 52,2002,2002<br /></font><font color="#007700">echo </font><font color="#DD0000">"12/28/2002 - %V,%G,%Y = " </font><font color="#007700">. </font><font color="#0000BB">strftime</font><font color="#007700">(</font><font color="#DD0000">"%V,%G,%Y"</font><font color="#007700">, </font><font color="#0000BB">strtotime</font><font color="#007700">(</font><font color="#DD0000">"12/28/2002"</font><font color="#007700">)) . </font><font color="#DD0000">"\n"</font><font color="#007700">;<br /><br /></font><font color="#FF8000">// Outputs: 12/30/2002 - %V,%G,%Y = 1,2003,2002<br /></font><font color="#007700">echo </font><font color="#DD0000">"12/30/2002 - %V,%G,%Y = " </font><font color="#007700">. </font><font color="#0000BB">strftime</font><font color="#007700">(</font><font color="#DD0000">"%V,%G,%Y"</font><font color="#007700">, </font><font color="#0000BB">strtotime</font><font color="#007700">(</font><font color="#DD0000">"12/30/2002"</font><font color="#007700">)) . </font><font color="#DD0000">"\n"</font><font color="#007700">;<br /><br /></font><font color="#FF8000">// Outputs: 1/3/2003 - %V,%G,%Y = 1,2003,2003<br /></font><font color="#007700">echo </font><font color="#DD0000">"1/3/2003 - %V,%G,%Y = " </font><font color="#007700">. </font><font color="#0000BB">strftime</font><font color="#007700">(</font><font color="#DD0000">"%V,%G,%Y"</font><font color="#007700">,</font><font color="#0000BB">strtotime</font><font color="#007700">(</font><font color="#DD0000">"1/3/2003"</font><font color="#007700">)) . </font><font color="#DD0000">"\n"</font><font color="#007700">;<br /><br /></font><font color="#FF8000">// Outputs: 1/10/2003 - %V,%G,%Y = 2,2003,2003<br /></font><font color="#007700">echo </font><font color="#DD0000">"1/10/2003 - %V,%G,%Y = " </font><font color="#007700">. </font><font color="#0000BB">strftime</font><font color="#007700">(</font><font color="#DD0000">"%V,%G,%Y"</font><font color="#007700">,</font><font color="#0000BB">strtotime</font><font color="#007700">(</font><font color="#DD0000">"1/10/2003"</font><font color="#007700">)) . </font><font color="#DD0000">"\n"</font><font color="#007700">;<br /><br /><br /><br /></font><font color="#FF8000">/*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;December 2004 / January 2005<br />ISOWk&nbsp;&nbsp;M&nbsp;&nbsp;&nbsp;Tu&nbsp;&nbsp;W&nbsp;&nbsp;&nbsp;Thu F&nbsp;&nbsp;&nbsp;Sa&nbsp;&nbsp;Su<br />----- ----------------------------<br />51&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;13&nbsp;&nbsp;14&nbsp;&nbsp;15&nbsp;&nbsp;16&nbsp;&nbsp;17&nbsp;&nbsp;18&nbsp;&nbsp;19<br />52&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;20&nbsp;&nbsp;21&nbsp;&nbsp;22&nbsp;&nbsp;23&nbsp;&nbsp;24&nbsp;&nbsp;25&nbsp;&nbsp;26<br />53&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;27&nbsp;&nbsp;28&nbsp;&nbsp;29&nbsp;&nbsp;30&nbsp;&nbsp;31&nbsp;&nbsp;&nbsp;1&nbsp;&nbsp;&nbsp;2<br />1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;3&nbsp;&nbsp;&nbsp;4&nbsp;&nbsp;&nbsp;5&nbsp;&nbsp;&nbsp;6&nbsp;&nbsp;&nbsp;7&nbsp;&nbsp;&nbsp;8&nbsp;&nbsp;&nbsp;9<br />2&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;10&nbsp;&nbsp;11&nbsp;&nbsp;12&nbsp;&nbsp;13&nbsp;&nbsp;14&nbsp;&nbsp;15&nbsp;&nbsp;16&nbsp;&nbsp;&nbsp;*/<br /><br />// Outputs: 12/23/2004 - %V,%G,%Y = 52,2004,2004<br /></font><font color="#007700">echo </font><font color="#DD0000">"12/23/2004 - %V,%G,%Y = " </font><font color="#007700">. </font><font color="#0000BB">strftime</font><font color="#007700">(</font><font color="#DD0000">"%V,%G,%Y"</font><font color="#007700">,</font><font color="#0000BB">strtotime</font><font color="#007700">(</font><font color="#DD0000">"12/23/2004"</font><font color="#007700">)) . </font><font color="#DD0000">"\n"</font><font color="#007700">;<br /><br /></font><font color="#FF8000">// Outputs: 12/31/2004 - %V,%G,%Y = 53,2004,2004<br /></font><font color="#007700">echo </font><font color="#DD0000">"12/31/2004 - %V,%G,%Y = " </font><font color="#007700">. </font><font color="#0000BB">strftime</font><font color="#007700">(</font><font color="#DD0000">"%V,%G,%Y"</font><font color="#007700">,</font><font color="#0000BB">strtotime</font><font color="#007700">(</font><font color="#DD0000">"12/31/2004"</font><font color="#007700">)) . </font><font color="#DD0000">"\n"</font><font color="#007700">;<br /><br /></font><font color="#FF8000">// Outputs: 1/2/2005 - %V,%G,%Y = 53,2004,2005<br /></font><font color="#007700">echo </font><font color="#DD0000">"1/2/2005 - %V,%G,%Y = " </font><font color="#007700">. </font><font color="#0000BB">strftime</font><font color="#007700">(</font><font color="#DD0000">"%V,%G,%Y"</font><font color="#007700">,</font><font color="#0000BB">strtotime</font><font color="#007700">(</font><font color="#DD0000">"1/2/2005"</font><font color="#007700">)) . </font><font color="#DD0000">"\n"</font><font color="#007700">;<br /><br /></font><font color="#FF8000">// Outputs: 1/3/2005 - %V,%G,%Y = 1,2005,2005<br /></font><font color="#007700">echo </font><font color="#DD0000">"1/3/2005 - %V,%G,%Y = " </font><font color="#007700">. </font><font color="#0000BB">strftime</font><font color="#007700">(</font><font color="#DD0000">"%V,%G,%Y"</font><font color="#007700">,</font><font color="#0000BB">strtotime</font><font color="#007700">(</font><font color="#DD0000">"1/3/2005"</font><font color="#007700">)) . </font><font color="#DD0000">"\n"</font><font color="#007700">;<br /><br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
    </P
><P
>&#13;     Veja também <A
HREF="function.setlocale.html"
><B
CLASS="function"
>setlocale()</B
></A
>,
     <A
HREF="function.mktime.html"
><B
CLASS="function"
>mktime()</B
></A
>, e a <A
HREF="http://www.opengroup.org/onlinepubs/007908799/xsh/strftime.html"
TARGET="_top"
>&#13;     especificação do Open Group specification de
     <B
CLASS="function"
>strftime()</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.mktime.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.strptime.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>mktime</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"
>strptime</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>

Perl :: Catalyst :: PostgreSQL :: RPM Valid HTML 4.01 Transitional