<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/refs.calendar.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'book.datetime.php',
    1 => 'Data/Hor&aacute;rio',
    2 => 'Data e Hor&aacute;rio',
  ),
  'up' => 
  array (
    0 => 'refs.calendar.php',
    1 => 'Extens&otilde;es Relacionadas a Data e Hor&aacute;rio',
  ),
  'prev' => 
  array (
    0 => 'function.unixtojd.php',
    1 => 'unixtojd',
  ),
  'next' => 
  array (
    0 => 'datetime.setup.php',
    1 => 'Instala&ccedil;&atilde;o/Configura&ccedil;&atilde;o',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/datetime/book.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/book.datetime.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="book.datetime" class="book">
 
 <h1 class="title">Data e Horário</h1>
 

 
 <div id="intro.datetime" class="preface">
  <h1 class="title">Introdução</h1>
  <p class="para">
   A classe <span class="classname"><a href="class.datetimeimmutable.php" class="classname">DateTimeImmutable</a></span> e classes relacionadas permitem
   representar informações de data/horário. Os objetos podem ser criados passando-se uma
   representação de informação de data/horário no formato string, ou a partir do horário
   atual do sistema.
  </p>
  <p class="para">
   Existe também um conjunto rico de métodos para modificar e formatar estas informações,
   incluindo manipulação de fusos horários e transições de horários de verão.
  </p>
  <p class="para">
   As características de data/horário no PHP implementam o calendário ISO 8601, que é um
   <a href="https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar" class="link external">&raquo;&nbsp;calendário gregoriano
   proléptico</a> que implementa as regras atuais de anos bissextos estendidas a períodos anteriores
   ao que o calendário gregoriano foi adotado, e também inclui o ano
   <code class="literal">0</code> como o número do ano entre <code class="literal">-1
   AEC</code> e <code class="literal">1 EC</code>. Segundos intercalares não são suportados.
  </p>
  <p class="para">
   A informação de data e horário é armazenada internamente como um número de 64 bits, sendo assim,
   todas as datas úteis concebíveis (incluindo anos negativos) são suportadas. O intervalo
   vai de aproximadamente 292 bilhões de anos no passado até o mesmo valor
   no futuro.
  </p>
  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <span class="simpara">
    Os fusos horários referenciados nesta seção podem ser encontrados em
    <a href="timezones.php" class="xref">Lista de Fusos Hor&aacute;rios Suportados</a>.
   </span>
  </p></blockquote>
 </div>
 

 







 




 







 




 




 




 




 




 





 








 

 






 












 



 



 



 



 



 



 



 



 




<ul class="chunklist chunklist_book"><li><a href="datetime.setup.php">Instala&ccedil;&atilde;o/Configura&ccedil;&atilde;o</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="datetime.installation.php">Instala&ccedil;&atilde;o</a></li><li><a href="datetime.configuration.php">Configura&ccedil;&otilde;es em Execu&ccedil;&atilde;o</a></li></ul></li><li><a href="datetime.constants.php">Constantes predefinidas</a></li><li><a href="datetime.examples.php">Exemplos</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="datetime.examples-arithmetic.php">Aritm&eacute;tica de Data e Hor&aacute;rio</a></li></ul></li><li><a href="class.datetime.php">DateTime</a> — A classe DateTime<ul class="chunklist chunklist_book chunklist_children"><li><a href="datetime.add.php">DateTime::add</a> — Modifica um objeto DateTime, com adi&ccedil;&atilde;o de dias, meses, anos, horas, minutos e segundos.</li><li><a href="datetime.construct.php">DateTime::__construct</a> — Retorna um novo objeto DateTime</li><li><a href="datetime.createfromformat.php">DateTime::createFromFormat</a> — Interpreta um string de data/hor&aacute;rio de acordo com um formato especificado.</li><li><a href="datetime.createfromimmutable.php">DateTime::createFromImmutable</a> — Retorna uma nova inst&acirc;ncia de DateTime encapsulando o objeto DateTimeImmutable informado</li><li><a href="datetime.createfrominterface.php">DateTime::createFromInterface</a> — Retorna um novo objeto DateTime encapsulando o objeto DateTimeInterface informado</li><li><a href="datetime.getlasterrors.php">DateTime::getLastErrors</a> — Sin&ocirc;nimo de DateTimeImmutable::getLastErrors</li><li><a href="datetime.modify.php">DateTime::modify</a> — Altera o timestamp</li><li><a href="datetime.set-state.php">DateTime::__set_state</a> — O manipulador __set_state</li><li><a href="datetime.setdate.php">DateTime::setDate</a> — Define a data</li><li><a href="datetime.setisodate.php">DateTime::setISODate</a> — Define uma data ISO</li><li><a href="datetime.settime.php">DateTime::setTime</a> — Define o hor&aacute;rio</li><li><a href="datetime.settimestamp.php">DateTime::setTimestamp</a> — Define a data e hora baseada em um timestamp Unix</li><li><a href="datetime.settimezone.php">DateTime::setTimezone</a> — Define o fuso hor&aacute;rio de um objeto DateTime</li><li><a href="datetime.sub.php">DateTime::sub</a> — Subtrai uma quantidade de dias, meses, anos, horas, minutos e segundos de
   um objeto DateTime</li></ul></li><li><a href="class.datetimeimmutable.php">DateTimeImmutable</a> — A classe DateTimeImmutable<ul class="chunklist chunklist_book chunklist_children"><li><a href="datetimeimmutable.add.php">DateTimeImmutable::add</a> — Retorna um novo objeto, com adi&ccedil;&atilde;o de dias, meses, anos, horas, minutos e segundos</li><li><a href="datetimeimmutable.construct.php">DateTimeImmutable::__construct</a> — Retorna um novo objeto DateTimeImmutable</li><li><a href="datetimeimmutable.createfromformat.php">DateTimeImmutable::createFromFormat</a> — Interpreta um string de data/hor&aacute;rio de acordo com o formato especificado</li><li><a href="datetimeimmutable.createfrominterface.php">DateTimeImmutable::createFromInterface</a> — Retorna um novo objeto DateTimeImmutable encapsulando o objeto DateTimeInterface informado</li><li><a href="datetimeimmutable.createfrommutable.php">DateTimeImmutable::createFromMutable</a> — Retorna uma nova inst&acirc;ncia DateTimeImmutable que encapsula um objeto DateTime informado</li><li><a href="datetimeimmutable.getlasterrors.php">DateTimeImmutable::getLastErrors</a> — Retorna os avisos e erros</li><li><a href="datetimeimmutable.modify.php">DateTimeImmutable::modify</a> — Cria um novo objeto com seu timestamp modificado</li><li><a href="datetimeimmutable.set-state.php">DateTimeImmutable::__set_state</a> — O manipulador __set_state</li><li><a href="datetimeimmutable.setdate.php">DateTimeImmutable::setDate</a> — Define a data</li><li><a href="datetimeimmutable.setisodate.php">DateTimeImmutable::setISODate</a> — Define a data ISO</li><li><a href="datetimeimmutable.settime.php">DateTimeImmutable::setTime</a> — Define um hor&aacute;rio</li><li><a href="datetimeimmutable.settimestamp.php">DateTimeImmutable::setTimestamp</a> — Define a data e o hor&aacute;rio com base em um timestamp Unix</li><li><a href="datetimeimmutable.settimezone.php">DateTimeImmutable::setTimezone</a> — Define o fuso hor&aacute;rio</li><li><a href="datetimeimmutable.sub.php">DateTimeImmutable::sub</a> — Subtrai uma quantidade de dias, meses, anos, horas, minutos e segundos</li></ul></li><li><a href="class.datetimeinterface.php">DateTimeInterface</a> — A interface DateTimeInterface<ul class="chunklist chunklist_book chunklist_children"><li><a href="datetime.diff.php">DateTimeInterface::diff</a> — Retorna a diferen&ccedil;a entre dois objetos DateTime</li><li><a href="datetime.format.php">DateTimeInterface::format</a> — Retorna a data formatada de acordo com um formato informado</li><li><a href="datetime.getoffset.php">DateTimeInterface::getOffset</a> — Retorna o deslocamento do fuso hor&aacute;rio</li><li><a href="datetime.gettimestamp.php">DateTimeInterface::getTimestamp</a> — Obt&eacute;m o timestamp Unix</li><li><a href="datetime.gettimezone.php">DateTimeInterface::getTimezone</a> — Retorna o fuso hor&aacute;rio correspondente a um DateTime informado</li><li><a href="datetime.serialize.php">DateTime::__serialize</a> — Serializa um DateTime</li><li><a href="datetime.unserialize.php">DateTime::__unserialize</a> — Desserializa um Datetime</li><li><a href="datetime.wakeup.php">DateTime::__wakeup</a> — O manipulador __wakeup</li></ul></li><li><a href="class.datetimezone.php">DateTimeZone</a> — A classe DateTimeZone<ul class="chunklist chunklist_book chunklist_children"><li><a href="datetimezone.construct.php">DateTimeZone::__construct</a> — Cria um novo objeto DateTimeZone</li><li><a href="datetimezone.getlocation.php">DateTimeZone::getLocation</a> — Retorna informa&ccedil;&otilde;es da localiza&ccedil;&atilde;o de um fuso hor&aacute;rio</li><li><a href="datetimezone.getname.php">DateTimeZone::getName</a> — Retorna o nome do fuso hor&aacute;rio</li><li><a href="datetimezone.getoffset.php">DateTimeZone::getOffset</a> — Retorna o deslocamento do fuso hor&aacute;rio em rela&ccedil;&atilde;o ao GMT</li><li><a href="datetimezone.gettransitions.php">DateTimeZone::getTransitions</a> — Retorna todas as transi&ccedil;&otilde;es para o fuso hor&aacute;rio</li><li><a href="datetimezone.listabbreviations.php">DateTimeZone::listAbbreviations</a> — Retorna um array associativo contendo indicativo de hor&aacute;rio de ver&atilde;o, deslocamento e nome do fuso hor&aacute;rio</li><li><a href="datetimezone.listidentifiers.php">DateTimeZone::listIdentifiers</a> — Retorna um array numericamente indexado contendo todos os indenticadores de fuso hor&aacute;rio</li></ul></li><li><a href="class.dateinterval.php">DateInterval</a> — A classe DateInterval<ul class="chunklist chunklist_book chunklist_children"><li><a href="dateinterval.construct.php">DateInterval::__construct</a> — Cria um novo objeto DateInterval</li><li><a href="dateinterval.createfromdatestring.php">DateInterval::createFromDateString</a> — Cria um DateInterval de por&ccedil;&otilde;es relativas da string</li><li><a href="dateinterval.format.php">DateInterval::format</a> — Formata um intervalo</li></ul></li><li><a href="class.dateperiod.php">DatePeriod</a> — A classe DatePeriod<ul class="chunklist chunklist_book chunklist_children"><li><a href="dateperiod.construct.php">DatePeriod::__construct</a> — Cria um novo objeto DatePeriod</li><li><a href="dateperiod.createfromiso8601string.php">DatePeriod::createFromISO8601String</a> — Cria um novo objeto DatePeriod a partir de uma string ISO8601</li><li><a href="dateperiod.getdateinterval.php">DatePeriod::getDateInterval</a> — Obt&eacute;m o intervalo</li><li><a href="dateperiod.getenddate.php">DatePeriod::getEndDate</a> — Obt&eacute;m a data final</li><li><a href="dateperiod.getrecurrences.php">DatePeriod::getRecurrences</a> — Obt&eacute;m o n&uacute;mero de recorr&ecirc;ncias</li><li><a href="dateperiod.getstartdate.php">DatePeriod::getStartDate</a> — Obt&eacute;m a data inicial</li></ul></li><li><a href="ref.datetime.php">Fun&ccedil;&otilde;es de Data/Hor&aacute;rio</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="function.checkdate.php">checkdate</a> — Valida uma data gregoriana</li><li><a href="function.date.php">date</a> — Formata um timestamp Unix</li><li><a href="function.date-add.php">date_add</a> — Sin&ocirc;nimo de DateTime::add</li><li><a href="function.date-create.php">date_create</a> — Cria um novo objeto DateTime</li><li><a href="function.date-create-from-format.php">date_create_from_format</a> — Sin&ocirc;nimo de DateTime::createFromFormat</li><li><a href="function.date-create-immutable.php">date_create_immutable</a> — Cria um novo objeto DateTimeImmutable</li><li><a href="function.date-create-immutable-from-format.php">date_create_immutable_from_format</a> — Sin&ocirc;nimo de DateTimeImmutable::createFromFormat</li><li><a href="function.date-date-set.php">date_date_set</a> — Sin&ocirc;nimo de DateTime::setDate</li><li><a href="function.date-default-timezone-get.php">date_default_timezone_get</a> — Retorna o fuso hor&aacute;rio padr&atilde;o usado por todas as fun&ccedil;&otilde;es de data/hor&aacute;rio em um script</li><li><a href="function.date-default-timezone-set.php">date_default_timezone_set</a> — Configura o fuso hor&aacute;rio padr&atilde;o utilizado por todas as fun&ccedil;&otilde;es de data/hor&aacute;rio em um script</li><li><a href="function.date-diff.php">date_diff</a> — Sin&ocirc;nimo de DateTime::diff</li><li><a href="function.date-format.php">date_format</a> — Sin&ocirc;nimo de DateTime::format</li><li><a href="function.date-get-last-errors.php">date_get_last_errors</a> — Sin&ocirc;nimo de DateTimeImmutable::getLastErrors</li><li><a href="function.date-interval-create-from-date-string.php">date_interval_create_from_date_string</a> — Sin&ocirc;nimo de DateInterval::createFromDateString</li><li><a href="function.date-interval-format.php">date_interval_format</a> — Sin&ocirc;nimo de DateInterval::format</li><li><a href="function.date-isodate-set.php">date_isodate_set</a> — Sin&ocirc;nimo de DateTime::setISODate</li><li><a href="function.date-modify.php">date_modify</a> — Sin&ocirc;nimo de DateTime::modify</li><li><a href="function.date-offset-get.php">date_offset_get</a> — Sin&ocirc;nimo de DateTime::getOffset</li><li><a href="function.date-parse.php">date_parse</a> — Retorna um array associativo com informa&ccedil;&otilde;es detalhadas da data/hor&aacute;rio informada</li><li><a href="function.date-parse-from-format.php">date_parse_from_format</a> — Retorna informa&ccedil;&otilde;es sobre uma data informada de acordo com um formato</li><li><a href="function.date-sub.php">date_sub</a> — Sin&ocirc;nimo de DateTime::sub</li><li><a href="function.date-sun-info.php">date_sun_info</a> — Retorna um array com informa&ccedil;&otilde;es sobre p&ocirc;r/nascer do sol e o in&iacute;cio/fim do dia</li><li><a href="function.date-sunrise.php">date_sunrise</a> — Retorna a hora do nascer do sol para um dia e uma localica&ccedil;&atilde;o informados</li><li><a href="function.date-sunset.php">date_sunset</a> — Retorna a hora do p&ocirc;r do sol para um dia e uma localiza&ccedil;&atilde;o informados.</li><li><a href="function.date-time-set.php">date_time_set</a> — Sin&ocirc;nimo de DateTime::setTime</li><li><a href="function.date-timestamp-get.php">date_timestamp_get</a> — Sin&ocirc;nimo de DateTime::getTimestamp</li><li><a href="function.date-timestamp-set.php">date_timestamp_set</a> — Sin&ocirc;nimo de DateTime::setTimestamp</li><li><a href="function.date-timezone-get.php">date_timezone_get</a> — Sin&ocirc;nimo de DateTime::getTimezone</li><li><a href="function.date-timezone-set.php">date_timezone_set</a> — Sin&ocirc;nimo de DateTime::setTimezone</li><li><a href="function.getdate.php">getdate</a> — Recupera informa&ccedil;&otilde;es de data/hor&aacute;rio</li><li><a href="function.gettimeofday.php">gettimeofday</a> — Obt&eacute;m o hor&aacute;rio atual</li><li><a href="function.gmdate.php">gmdate</a> — Formata uma data/hor&aacute;rio GMT/CUT</li><li><a href="function.gmmktime.php">gmmktime</a> — Obt&eacute;m um timestamp Unix para uma data GMT</li><li><a href="function.gmstrftime.php">gmstrftime</a> — Formata uma data/hor&aacute;rio GMT/UTC de acordo com as configura&ccedil;&otilde;es de localidade</li><li><a href="function.idate.php">idate</a> — Formata uma parte de uma data/hor&aacute;rio local como um inteiro</li><li><a href="function.localtime.php">localtime</a> — Obt&eacute;m o hor&aacute;rio local</li><li><a href="function.microtime.php">microtime</a> — Retorna o timestamp Unix atual com microssegundos</li><li><a href="function.mktime.php">mktime</a> — Obt&eacute;m um timestamp Unix de uma data</li><li><a href="function.strftime.php">strftime</a> — Formata uma data/hor&aacute;rio de acordo com as configura&ccedil;&otilde;es locais</li><li><a href="function.strptime.php">strptime</a> — Interpreta uma data/hor&aacute;rio gerada pela fun&ccedil;&atilde;o strftime</li><li><a href="function.strtotime.php">strtotime</a> — Interpreta qualquer descri&ccedil;&atilde;o textual de data/hor&aacute;rio em ingl&ecirc;s para timestamp Unix</li><li><a href="function.time.php">time</a> — Retorna o timestamp Unix atual</li><li><a href="function.timezone-abbreviations-list.php">timezone_abbreviations_list</a> — Sin&ocirc;nimo de DateTimeZone::listAbbreviations</li><li><a href="function.timezone-identifiers-list.php">timezone_identifiers_list</a> — Sin&ocirc;nimo de DateTimeZone::listIdentifiers</li><li><a href="function.timezone-location-get.php">timezone_location_get</a> — Sin&ocirc;nimo de DateTimeZone::getLocation</li><li><a href="function.timezone-name-from-abbr.php">timezone_name_from_abbr</a> — Retorna um nome de fuso hor&aacute;rio atrav&eacute;s da abrevia&ccedil;&atilde;o e do deslocamento UTC</li><li><a href="function.timezone-name-get.php">timezone_name_get</a> — Sin&ocirc;nimo de DateTimeZone::getName</li><li><a href="function.timezone-offset-get.php">timezone_offset_get</a> — Sin&ocirc;nimo de DateTimeZone::getOffset</li><li><a href="function.timezone-open.php">timezone_open</a> — Sin&ocirc;nimo de DateTimeZone::__construct</li><li><a href="function.timezone-transitions-get.php">timezone_transitions_get</a> — Sin&ocirc;nimo de DateTimeZone::getTransitions</li><li><a href="function.timezone-version-get.php">timezone_version_get</a> — Obt&eacute;m a vers&atilde;o do banco de dados de fuso hor&aacute;rio.</li></ul></li><li><a href="datetime.error.tree.php">Erros e Exce&ccedil;&otilde;es de Data/Hor&aacute;rio</a></li><li><a href="datetime.formats.php">Formatos de Data e Hor&aacute;rio Suportados</a></li><li><a href="timezones.php">Lista de Fusos Hor&aacute;rios Suportados</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="timezones.africa.php">&Aacute;frica</a></li><li><a href="timezones.america.php">Am&eacute;rica</a></li><li><a href="timezones.antarctica.php">Ant&aacute;rtica</a></li><li><a href="timezones.arctic.php">&Aacute;rtico</a></li><li><a href="timezones.asia.php">&Aacute;sia</a></li><li><a href="timezones.atlantic.php">Atl&acirc;ntico</a></li><li><a href="timezones.australia.php">Austr&aacute;lia</a></li><li><a href="timezones.europe.php">Europa</a></li><li><a href="timezones.indian.php">&Iacute;ndia</a></li><li><a href="timezones.pacific.php">Pac&iacute;fico</a></li><li><a href="timezones.others.php">Outros</a></li></ul></li><li><a href="class.dateerror.php">DateError</a> — A classe DateError</li><li><a href="class.dateobjecterror.php">DateObjectError</a> — A classe DateObjectError</li><li><a href="class.daterangeerror.php">DateRangeError</a> — A classe DateRangeError</li><li><a href="class.dateexception.php">DateException</a> — A classe DateException</li><li><a href="class.dateinvalidoperationexception.php">DateInvalidOperationException</a> — A classe DateInvalidOperationException</li><li><a href="class.dateinvalidtimezoneexception.php">DateInvalidTimeZoneException</a> — A classe DateInvalidTimeZoneException</li><li><a href="class.datemalformedintervalstringexception.php">DateMalformedIntervalStringException</a> — The DateMalformedIntervalStringException class</li><li><a href="class.datemalformedperiodstringexception.php">DateMalformedPeriodStringException</a> — A classe DateMalformedPeriodStringException</li><li><a href="class.datemalformedstringexception.php">DateMalformedStringException</a> — A classe DateMalformedStringException</li></ul></div><?php manual_footer($setup); ?>