mirror of
https://github.com/php/doc-zh.git
synced 2026-03-24 23:22:14 +01:00
116 lines
4.1 KiB
XML
116 lines
4.1 KiB
XML
<?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
|
||
-->
|
||
|