<!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 -- 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 > <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 > 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 > 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 > <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 > <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"><?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">?></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 > <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 > 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"><?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 /> <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">?></font> </font> </code></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > </P ><P > 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 > 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 >