<?xml version="1.0" encoding="utf-8"?>

<!-- $Revision$ -->

<!-- EN-Revision: 3a8c3e77df070a046c9d5b56b68926ca2d7e5ee3 Maintainer: yuanyuqiang Status: ready -->

<!-- CREDITS: mowangjuanzi -->

<book xml:id="book.datetime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="interactive">

<?phpdoc extension-membership="core"?>

<title>日期和时间</title>

<titleabbrev>日期/时间</titleabbrev>

<!-- {{{ preface -->

<preface xml:id="intro.datetime">

&reftitle.intro;

<para>

<classname>DateTimeImmutable</classname>

和关联类允许表示日期/时间信息。通过传递字符串表述的日期/时间信息或从当前系统时间来创建这些对象。

</para>

<para>

还提供了丰富的方法来修改和格式化这些信息，包括处理时区和 DST（夏令时）转换。

</para>

<para>

PHP 中的日期/时间功能实现了 ISO 8601 历法，这是<link xlink:href="&url.proleptic-gregorian-calendar;"

>前公历</link>，实现了公历之前的当前闰日规则，并且还包括 <literal>0</literal>

年作为介于两者之间的年份——<literal>公元前 1 年</literal>和<literal>公元 1 年</literal>。不支持闰秒。

</para>

<para>

日期和时间信息在内部是以 64 位数字存储的，所以支持所有可能有用的日期（包括负数年份）。其范围覆盖当前时间前后

2920 亿年的时间。

</para>

<note>

<simpara>

本节中用到的时区可以从<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>日期/时间 Error 和 Exception</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

-->