mirror of
https://github.com/sigmasternchen/php-doc-en
synced 2025-03-16 00:48:54 +00:00
removed illegal "000" example from the doy format (as per note#113201) & reordered the example values to correspond to the actual format
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@336882 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Maciek Sokolewicz
parent
5cc2d1edfb
commit
5edd406c8c
1 changed files with 44 additions and 37 deletions
|
|
@ -2,7 +2,7 @@
|
|||
<!-- $Revision$ -->
|
||||
<chapter xml:id="datetime.formats" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<title>Supported Date and Time Formats</title>
|
||||
|
||||
|
||||
<para>
|
||||
This section describes all the different formats that the
|
||||
<function>strtotime</function>, <classname>DateTime</classname>
|
||||
|
|
@ -16,7 +16,7 @@
|
|||
double quotes are case-sensitive (<literal>"T"</literal> is only
|
||||
<literal>T</literal>).
|
||||
</para>
|
||||
|
||||
|
||||
<!--Time Formats: {{{-->
|
||||
<sect1 xml:id="datetime.formats.time">
|
||||
<title>Time Formats</title>
|
||||
|
|
@ -26,7 +26,7 @@
|
|||
<function>strtotime</function>, <classname>DateTime</classname> and
|
||||
<function>date_create</function> parser understands.
|
||||
</para>
|
||||
|
||||
|
||||
<table>
|
||||
<title>Used Symbols</title>
|
||||
<tgroup cols="3">
|
||||
|
|
@ -36,6 +36,13 @@
|
|||
<entry>Formats</entry>
|
||||
<entry>Examples</entry>
|
||||
</row>
|
||||
|
||||
<refsect1 role="unicode"><!-- {{{ -->
|
||||
&reftitle.unicode;
|
||||
<para>
|
||||
Information specific to unicode, from the PHP 6 changes.
|
||||
</para>
|
||||
</refsect1><!-- }}} -->
|
||||
</thead>
|
||||
<tbody>
|
||||
<row>
|
||||
|
|
@ -86,7 +93,7 @@
|
|||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
|
||||
<table>
|
||||
<title>12 Hour Notation</title>
|
||||
<tgroup cols="3">
|
||||
|
|
@ -121,7 +128,7 @@
|
|||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
|
||||
<table>
|
||||
<title>24 Hour Notation</title>
|
||||
<tgroup cols="3">
|
||||
|
|
@ -173,7 +180,7 @@
|
|||
</table>
|
||||
</sect1>
|
||||
<!--}}}-->
|
||||
|
||||
|
||||
<!--Date Formats: {{{-->
|
||||
<sect1 xml:id="datetime.formats.date">
|
||||
<title>Date Formats</title>
|
||||
|
|
@ -183,7 +190,7 @@
|
|||
<function>strtotime</function>, <classname>DateTime</classname> and
|
||||
<function>date_create</function> parser understands.
|
||||
</para>
|
||||
|
||||
|
||||
<table>
|
||||
<title>Used Symbols</title>
|
||||
<tgroup cols="3">
|
||||
|
|
@ -213,16 +220,16 @@
|
|||
<row>
|
||||
<entry><literal>m</literal></entry>
|
||||
<entry>'january' | 'february' | 'march' | 'april' | 'may' | 'june' |
|
||||
'july' | 'august' | 'september' | 'october' | 'november' | 'december' |
|
||||
'jan' | 'feb' | 'mar' | 'apr' | 'may' | 'jun' | 'jul' | 'aug' | 'sep' |
|
||||
'sept' | 'oct' | 'nov' | 'dec' | "I" | "II" | "III" | "IV" | "V" | "VI"
|
||||
| "VII" | "VIII" | "IX" | "X" | "XI" | "XII"</entry>
|
||||
'july' | 'august' | 'september' | 'october' | 'november' | 'december' |
|
||||
'jan' | 'feb' | 'mar' | 'apr' | 'may' | 'jun' | 'jul' | 'aug' | 'sep' |
|
||||
'sept' | 'oct' | 'nov' | 'dec' | "I" | "II" | "III" | "IV" | "V" | "VI"
|
||||
| "VII" | "VIII" | "IX" | "X" | "XI" | "XII"</entry>
|
||||
<entry></entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><literal>M</literal></entry>
|
||||
<entry>'jan' | 'feb' | 'mar' | 'apr' | 'may' | 'jun' | 'jul' | 'aug' |
|
||||
'sep' | 'sept' | 'oct' | 'nov' | 'dec'</entry>
|
||||
'sep' | 'sept' | 'oct' | 'nov' | 'dec'</entry>
|
||||
<entry></entry>
|
||||
</row>
|
||||
<row>
|
||||
|
|
@ -253,7 +260,7 @@
|
|||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
|
||||
<table>
|
||||
<title>Localized Notations</title>
|
||||
<tgroup cols="3">
|
||||
|
|
@ -388,7 +395,7 @@
|
|||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
|
||||
<note>
|
||||
<para>
|
||||
For the <literal>y</literal> and <literal>yy</literal>
|
||||
|
|
@ -400,7 +407,7 @@
|
|||
interpreted as "2000-01-01".
|
||||
</para>
|
||||
</note>
|
||||
|
||||
|
||||
<note>
|
||||
<para>
|
||||
The "Day, month and two digit year, with dots or tabs" format
|
||||
|
|
@ -411,7 +418,7 @@
|
|||
[.:] <literal>SS</literal>" has precedence.
|
||||
</para>
|
||||
</note>
|
||||
|
||||
|
||||
<note>
|
||||
<para>
|
||||
The "Year (and just the year)" format only works if a time string
|
||||
|
|
@ -419,7 +426,7 @@
|
|||
<literal>HH</literal> <literal>MM</literal>.
|
||||
</para>
|
||||
</note>
|
||||
|
||||
|
||||
<note>
|
||||
<para>
|
||||
It is possible to over- and underflow the <literal>dd</literal> and
|
||||
|
|
@ -445,17 +452,17 @@
|
|||
</note>
|
||||
</sect1>
|
||||
<!--}}}-->
|
||||
|
||||
|
||||
<!--Compound Formats: {{{-->
|
||||
<sect1 xml:id="datetime.formats.compound">
|
||||
<title>Compound Formats</title>
|
||||
|
||||
|
||||
<para>
|
||||
This page describes the different compound date/time formats that the
|
||||
<function>strtotime</function>, <classname>DateTime</classname> and
|
||||
<function>date_create</function> parser understands.
|
||||
</para>
|
||||
|
||||
|
||||
<table>
|
||||
<title>Used Symbols</title>
|
||||
<tgroup cols="3">
|
||||
|
|
@ -475,7 +482,7 @@
|
|||
<row>
|
||||
<entry><literal>doy</literal></entry>
|
||||
<entry>"00"[1-9] | "0"[1-9][0-9] | [1-2][0-9][0-9] | "3"[0-5][0-9] | "36"[0-6]</entry>
|
||||
<entry>"36"[0-6] "000", "012", "366"</entry>
|
||||
<entry>"001", "012", "180", "350", "366"</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><literal>frac</literal></entry>
|
||||
|
|
@ -550,7 +557,7 @@
|
|||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
|
||||
<table>
|
||||
<title>Localized Notations</title>
|
||||
<tgroup cols="3">
|
||||
|
|
@ -620,7 +627,7 @@
|
|||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
|
||||
<note>
|
||||
<para>
|
||||
The "W" in the "ISO year with ISO week" and "ISO year with ISO week
|
||||
|
|
@ -637,7 +644,7 @@
|
|||
</note>
|
||||
</sect1>
|
||||
<!--}}}-->
|
||||
|
||||
|
||||
<!--Relative Formats: {{{-->
|
||||
<sect1 xml:id="datetime.formats.relative">
|
||||
<title>Relative Formats</title>
|
||||
|
|
@ -646,7 +653,7 @@
|
|||
<function>strtotime</function>, <classname>DateTime</classname> and
|
||||
<function>date_create</function> parser understands.
|
||||
</para>
|
||||
|
||||
|
||||
<table>
|
||||
<title>Used Symbols</title>
|
||||
<tgroup cols="2">
|
||||
|
|
@ -660,8 +667,8 @@
|
|||
<row>
|
||||
<entry><literal>dayname</literal></entry>
|
||||
<entry>'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' |
|
||||
'friday' | 'saturday' | 'sun' | 'mon' | 'tue' | 'wed' | 'thu' | 'fri' |
|
||||
'sat'</entry>
|
||||
'friday' | 'saturday' | 'sun' | 'mon' | 'tue' | 'wed' | 'thu' | 'fri' |
|
||||
'sat'</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><literal>daytext</literal></entry>
|
||||
|
|
@ -674,8 +681,8 @@
|
|||
<row>
|
||||
<entry><literal>ordinal</literal></entry>
|
||||
<entry>'first' | 'second' | 'third' | 'fourth' | 'fifth' | 'sixth' |
|
||||
'seventh' | 'eighth' | 'ninth' | 'tenth' | 'eleventh' | 'twelfth' |
|
||||
'next' | 'last' | 'previous' | 'this'</entry>
|
||||
'seventh' | 'eighth' | 'ninth' | 'tenth' | 'eleventh' | 'twelfth' |
|
||||
'next' | 'last' | 'previous' | 'this'</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><literal>reltext</literal></entry>
|
||||
|
|
@ -688,13 +695,13 @@
|
|||
<row>
|
||||
<entry><literal>unit</literal></entry>
|
||||
<entry>(('sec' | 'second' | 'min' | 'minute' | 'hour' | 'day' |
|
||||
'fortnight' | 'forthnight' | 'month' | 'year') 's'?) | 'weeks' |
|
||||
<literal>daytext</literal></entry>
|
||||
'fortnight' | 'forthnight' | 'month' | 'year') 's'?) | 'weeks' |
|
||||
<literal>daytext</literal></entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
|
||||
<table>
|
||||
<title>Day-based Notations</title>
|
||||
<tgroup cols="3">
|
||||
|
|
@ -749,13 +756,13 @@
|
|||
<row>
|
||||
<entry>'first day of'</entry>
|
||||
<entry>Sets the day of the first of the current month. This phrase is
|
||||
best used together with a month name following it.</entry>
|
||||
best used together with a month name following it.</entry>
|
||||
<entry>"first day of January 2008"</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry>'last day of'</entry>
|
||||
<entry>Sets the day to the last day of the current month. This phrase is
|
||||
best used together with a month name following it.</entry>
|
||||
best used together with a month name following it.</entry>
|
||||
<entry>"last day of next month"</entry>
|
||||
</row>
|
||||
<row>
|
||||
|
|
@ -796,7 +803,7 @@
|
|||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
|
||||
<note>
|
||||
<para>
|
||||
Relative statements are always processed <emphasis>after</emphasis>
|
||||
|
|
@ -812,7 +819,7 @@
|
|||
five statements directly influence the current time.
|
||||
</para>
|
||||
</note>
|
||||
|
||||
|
||||
<note>
|
||||
<para>
|
||||
Observe the following remarks when the current day-of-week is the
|
||||
|
|
@ -952,7 +959,7 @@
|
|||
</sect2>
|
||||
</sect1>
|
||||
<!--}}}-->
|
||||
|
||||
|
||||
</chapter>
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
|
|
|
|||
Loading…
Reference in a new issue