mirror of
https://github.com/php/doc-en.git
synced 2026-03-24 15:52:15 +01:00
124 lines
4.2 KiB
XML
124 lines
4.2 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
|
|
<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>Date and Time</title>
|
|
<titleabbrev>Date/Time</titleabbrev>
|
|
|
|
<!-- {{{ preface -->
|
|
<preface xml:id="intro.datetime">
|
|
&reftitle.intro;
|
|
<para>
|
|
The <classname>DateTimeImmutable</classname> and related classes allow you
|
|
represent date/time information. The objects can be created by passing in a
|
|
string presentation of date/time information, or from the current system's
|
|
time.
|
|
</para>
|
|
<para>
|
|
A rich set of methods is supplied to modify and format this information
|
|
as well, including handling timezones and DST transitions.
|
|
</para>
|
|
<para>
|
|
The date/time features in PHP implements the ISO 8601 calendar, which is a
|
|
<link xlink:href="&url.proleptic-gregorian-calendar;">proleptic Gregorian
|
|
calendar</link> which implements the current leap-day rules from before the
|
|
Gregorian calendar was in place, and also includes the year
|
|
<literal>0</literal> as the year number in between <literal>-1
|
|
BCE</literal> and <literal>1 CE</literal>. Leap seconds are not supported.
|
|
</para>
|
|
<para>
|
|
The date and time information is internally stored as a 64-bit number so
|
|
all conceivably useful dates (including negative years) are supported. The
|
|
range is from about 292 billion years in the past to the same in the
|
|
future.
|
|
</para>
|
|
<note>
|
|
<simpara>
|
|
The timezones referenced in this section can be found in the
|
|
<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>Date/Time Errors and Exceptions</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
|
|
-->
|
|
|