Sophie

Sophie

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

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
>mktime</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="microtime"
HREF="function.microtime.html"><LINK
REL="NEXT"
TITLE="strftime"
HREF="function.strftime.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.microtime.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.strftime.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.mktime"
></A
>mktime</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN26959"
></A
><P
>    (PHP 3, PHP 4, PHP 5)</P
>mktime&nbsp;--&nbsp;Obtém um timestamp Unix para uma data</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN26962"
></A
><H2
>Descrição</H2
>int <B
CLASS="methodname"
>mktime</B
> ( [int hora [, int minuto [, int second [, int mes [, int dia [, int ano [, int is_dst]]]]]]] )<BR
></BR
><P
>&#13;     <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Atenção:</I
></SPAN
> Note a estranha ordem dos argumentos,
	 que diferem da ordem dos argumentos em uma chamada regular da
     UNIX mktime() e que não combina bem omitir os
     parâmetros da direita para a esquerda (veja abaixo). É um erro comum
     misturar estes valores acima em um script.
    </P
><P
>&#13;     Retorna o timestamp Unix correspondente para os argumentos dados. 
	 Este timestamp é um longo inteiro contendo o número de segundos 
	 entre a Era Unix (January 1 1970) e o tempo especificado.
    </P
><P
>&#13;     Argumentos podem ser omitidos da direita para esquerda; quaisquer
     argumentos assim omitidos serão definidos para o valor atual de acordo
     com a data e a hora local.
    </P
><P
>&#13;     <CODE
CLASS="parameter"
>is_dst</CODE
> pode ser definido para 1 se está 
     durante o horário de verão, 0 se não estiver, ou -1 (o padrão)
     se não se sabe se está em horário de verão ou não.
	 Se é desconhecido, o PHP tenta calcular. Isto pode causar
     resultados inesperados (mas não incorretos).
	 </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
      <CODE
CLASS="parameter"
>is_dst</CODE
> adicionado no PHP 3.0.10.
     </P
></BLOCKQUOTE
></DIV
><P
>&#13;     <B
CLASS="function"
>mktime()</B
> é útil durante a aritmética e validação de data,
      enquanto ela calculará automaticamente o valor correto para a entrada out-of-range.
       Por exemplo, cada uma das seguintes
	 linhas produzirá a string "Jan-01-1998".
     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN26999"
></A
><P
><B
>Exemplo 1. <B
CLASS="function"
>mktime()</B
> exemplo</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /></font><font color="#007700">echo </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"M-d-Y"</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">12</font><font color="#007700">, </font><font color="#0000BB">32</font><font color="#007700">, </font><font color="#0000BB">1997</font><font color="#007700">));<br />echo </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"M-d-Y"</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">13</font><font color="#007700">, </font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">1997</font><font color="#007700">));<br />echo </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"M-d-Y"</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">1</font><font color="#007700">, </font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">1998</font><font color="#007700">));<br />echo </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">"M-d-Y"</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">1</font><font color="#007700">, </font><font color="#0000BB">1</font><font color="#007700">, </font><font color="#0000BB">98</font><font color="#007700">));<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
     <CODE
CLASS="parameter"
>Ano</CODE
> pode ser com 2 ou 4 dígitos,
     com valores entre 0-69 mapeando para 2000-2069 e 70-99 para
     1970-1999 (em sistemas onde time_t é um inteiro marcado de 32bit, como 
     a maioria de hoje, uma linha válida
     <CODE
CLASS="parameter"
>Ano</CODE
> é qualquer coisa entre 1901 e 2038).
    </P
><P
>&#13;     <DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Windows: </B
>
       Timestamp Negativos não são suportados dentro de uma versão conhecida de Windows.  Portanto a faixa de anos válidos inclui apenas 1970
       a 2038.
      </P
></BLOCKQUOTE
></DIV
>
    </P
><P
>&#13;     O último dia de um mês dado pode ser expressado como o dia "0" do mês seguinte, não o dia -1. Os dois exemplos seguintes
     produzirão a string "The last day in Feb 2000 is: 29".
     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN27010"
></A
><P
><B
>Exemplo 2. Último dia do próximo mês</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$lastday </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">3</font><font color="#007700">,</font><font color="#0000BB">0</font><font color="#007700">,</font><font color="#0000BB">2000</font><font color="#007700">);<br />echo </font><font color="#0000BB">strftime </font><font color="#007700">(</font><font color="#DD0000">"Last day in Feb 2000 is: %d"</font><font color="#007700">, </font><font color="#0000BB">$lastday</font><font color="#007700">);<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br /></font><font color="#0000BB">$lastday </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">4</font><font color="#007700">,-</font><font color="#0000BB">31</font><font color="#007700">,</font><font color="#0000BB">2000</font><font color="#007700">);<br />echo </font><font color="#0000BB">strftime </font><font color="#007700">(</font><font color="#DD0000">"Last day in Feb 2000 is: %d"</font><font color="#007700">, </font><font color="#0000BB">$lastday</font><font color="#007700">);<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
    </P
><P
>&#13;    Data com ano, mês e dia igual a zero é considerado ilegal
	 (de outra forma ele é considerado como 30.11.1999, que poderia ser um comportamento
	  estranho).
    </P
><P
>&#13;     Veja também <A
HREF="function.date.html"
><B
CLASS="function"
>date()</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.microtime.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.strftime.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>microtime</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"
>strftime</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>