Files
archived-doc-pt-br/reference/datetime/book.xml
Leonardo Lara Rodrigues 4d3b1c552b fix translations and typos
2025-08-05 08:39:22 -03:00

124 lines
4.5 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 71692b6f4cace8dca72a18ccd80d4cd7305e5d4e Maintainer: fabioluciano Status: ready --><!-- CREDITS: felipe, fabioluciano, leonardolara -->
<book xml:id="book.datetime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="core"?>
<title>Data e Horário</title>
<titleabbrev>Data/Horário</titleabbrev>
<!-- {{{ preface -->
<preface xml:id="intro.datetime">
&reftitle.intro;
<para>
A classe <classname>DateTimeImmutable</classname> e classes relacionadas permitem
representar informações de data/hora. Os objetos podem ser criados passando-se uma
representação de informação de data/hora no formato string, ou a partir do horário
atual do sistema.
</para>
<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.
</para>
<para>
As características de data/hora no PHP implementam o calendários ISO 8601, que é um
<link xlink:href="&url.proleptic-gregorian-calendar;">calendário gregoriano
proléptico</link> 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
<literal>0</literal> como o número do ano entre <literal>-1
AEC</literal> e <literal>1 EC</literal>. Segundos intercalares não são suportados.
</para>
<para>
A informação de data e hora é 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.
</para>
<note>
<simpara>
Os fusos horários referenciados nesta seção podem ser encontrados em
<xref linkend="timezones"/>.
</simpara>
</note>
</preface>
<!-- }}} -->
&reference.datetime.setup;
&reference.datetime.constants;
&reference.datetime.examples;
&reference.datetime.datetime;
&reference.datetime.datetimeimmutable;
&reference.datetime.datetimeinterface;
&reference.datetime.datetimezone;
&reference.datetime.dateinterval;
&reference.datetime.dateperiod;
&reference.datetime.reference;
<article xml:id="datetime.error.tree">
<title>Erros e Exceções de Data/Horário</title>
<itemizedlist>
<listitem>
<simpara><exceptionname>DateError</exceptionname> (extends <exceptionname>Error</exceptionname>)</simpara>
<itemizedlist>
<listitem>
<simpara><exceptionname>DateObjectError</exceptionname></simpara>
<simpara><exceptionname>DateRangeError</exceptionname></simpara>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<simpara><exceptionname>DateException</exceptionname> (extends <exceptionname>Exception</exceptionname>)</simpara>
<itemizedlist>
<listitem>
<itemizedlist>
<listitem><simpara><exceptionname>DateInvalidOperationException</exceptionname></simpara></listitem>
<listitem><simpara><exceptionname>DateInvalidTimezoneException</exceptionname></simpara></listitem>
<listitem><simpara><exceptionname>DateMalformedIntervalStringException</exceptionname></simpara></listitem>
<listitem><simpara><exceptionname>DateMalformedPeriodStringException</exceptionname></simpara></listitem>
<listitem><simpara><exceptionname>DateMalformedStringException</exceptionname></simpara></listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</article>
&reference.datetime.formats;
&reference.datetime.timezones;
&reference.datetime.dateerror;
&reference.datetime.dateobjecterror;
&reference.datetime.daterangeerror;
&reference.datetime.dateexception;
&reference.datetime.dateinvalidoperationexception;
&reference.datetime.dateinvalidtimezoneexception;
&reference.datetime.datemalformedintervalstringexception;
&reference.datetime.datemalformedperiodstringexception;
&reference.datetime.datemalformedstringexception;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->