nlopess Sat Jul 30 14:14:12 2005 EDT
Added files:
/phpdoc/en/reference/datetime constants.xml
Modified files:
/phpdoc/en/reference/datetime reference.xml
/phpdoc/en/reference/datetime/functions date.xml gmmktime.xml
mktime.xml strtotime.xml
Log:
add the new date constants.
deprecate is_dst parameter
document the new date() format chars
http://cvs.php.net/diff.php/phpdoc/en/reference/datetime/reference.xml?r1=1.8&r2=1.9&ty=u
Index: phpdoc/en/reference/datetime/reference.xml
diff -u phpdoc/en/reference/datetime/reference.xml:1.8
phpdoc/en/reference/datetime/reference.xml:1.9
--- phpdoc/en/reference/datetime/reference.xml:1.8 Wed Jun 22 15:33:34 2005
+++ phpdoc/en/reference/datetime/reference.xml Sat Jul 30 14:14:09 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
<reference id="ref.datetime">
<title>Date and Time Functions</title>
<titleabbrev>Date/Time</titleabbrev>
@@ -47,10 +47,7 @@
&no.resource;
</section>
- <section id="datetime.constants">
- &reftitle.constants;
- &no.constants;
- </section>
+ &reference.datetime.constants;
</partintro>
http://cvs.php.net/diff.php/phpdoc/en/reference/datetime/functions/date.xml?r1=1.18&r2=1.19&ty=u
Index: phpdoc/en/reference/datetime/functions/date.xml
diff -u phpdoc/en/reference/datetime/functions/date.xml:1.18
phpdoc/en/reference/datetime/functions/date.xml:1.19
--- phpdoc/en/reference/datetime/functions/date.xml:1.18 Sun Apr 24
19:50:57 2005
+++ phpdoc/en/reference/datetime/functions/date.xml Sat Jul 30 14:14:11 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.18 $ -->
+<!-- $Revision: 1.19 $ -->
<!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 -->
<refentry id="function.date">
<refnamediv>
@@ -144,6 +144,14 @@
<entry><literal>1</literal> if it is a leap year, <literal>0</literal>
otherwise.</entry>
</row>
<row>
+ <entry><literal>o</literal></entry>
+ <entry>ISO-8601 year number. This has the same value as
+ <literal>Y</literal>, except that if the ISO week number
+ (<literal>W</literal>) belongs to the previous or next year, that year
+ is used instead. (added in PHP 5.1.0)</entry>
+ <entry>Examples: <literal>1999</literal> or
<literal>2003</literal></entry>
+ </row>
+ <row>
<entry><literal>Y</literal></entry>
<entry>A full numeric representation of a year, 4 digits</entry>
<entry>Examples: <literal>1999</literal> or
<literal>2003</literal></entry>
@@ -209,6 +217,11 @@
<entry>---</entry>
</row>
<row>
+ <entry><literal>e</literal></entry>
+ <entry>Timezone identifier (added in PHP 5.1.0)</entry>
+ <entry>Examples: <literal>UTC</literal>, <literal>GMT</literal>,
<literal>Atlantic/Azores</literal></entry>
+ </row>
+ <row>
<entry><literal>I</literal> (capital i)</entry>
<entry>Whether or not the date is in daylights savings time</entry>
<entry><literal>1</literal> if Daylight Savings Time,
<literal>0</literal> otherwise.</entry>
http://cvs.php.net/diff.php/phpdoc/en/reference/datetime/functions/gmmktime.xml?r1=1.8&r2=1.9&ty=u
Index: phpdoc/en/reference/datetime/functions/gmmktime.xml
diff -u phpdoc/en/reference/datetime/functions/gmmktime.xml:1.8
phpdoc/en/reference/datetime/functions/gmmktime.xml:1.9
--- phpdoc/en/reference/datetime/functions/gmmktime.xml:1.8 Sun Apr 24
19:50:58 2005
+++ phpdoc/en/reference/datetime/functions/gmmktime.xml Sat Jul 30 14:14:11 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
<!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 -->
<refentry id="function.gmmktime">
<refnamediv>
@@ -31,6 +31,13 @@
from right to left, with any omitted arguments being set to the
current corresponding GMT value.
</para>
+ <note>
+ <para>
+ As of PHP 5.1.0, the <parameter>is_dst</parameter> parameter became
+ deprecated. As a result, the new timezone handling features should be used
+ instead.
+ </para>
+ </note>
<para>
<note>
<simpara>
http://cvs.php.net/diff.php/phpdoc/en/reference/datetime/functions/mktime.xml?r1=1.17&r2=1.18&ty=u
Index: phpdoc/en/reference/datetime/functions/mktime.xml
diff -u phpdoc/en/reference/datetime/functions/mktime.xml:1.17
phpdoc/en/reference/datetime/functions/mktime.xml:1.18
--- phpdoc/en/reference/datetime/functions/mktime.xml:1.17 Fri Jun 3
04:46:16 2005
+++ phpdoc/en/reference/datetime/functions/mktime.xml Sat Jul 30 14:14:11 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.17 $ -->
+<!-- $Revision: 1.18 $ -->
<!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 -->
<refentry id="function.mktime">
<refnamediv>
@@ -81,10 +81,11 @@
<listitem>
<para>
The number of the year, may be a two or four digit value,
- with values between 0-69 mapping to 2000-2069 and 70-99 to
- 1970-1999 (on systems where time_t is a 32bit signed integer, as
+ with values between 0-69 mapping to 2000-2069 and 70-100 to
+ 1970-2000. On systems where time_t is a 32bit signed integer, as
most common today, the valid range for <parameter>year</parameter>
- is somewhere between 1901 and 2038).
+ is somewhere between 1901 and 2038, although this limitation is
+ overcome as of PHP 5.1.0.
</para>
</listitem>
</varlistentry>
@@ -103,6 +104,12 @@
Some systems (e.g. Solaris 8) enable DST at midnight so time 0:30 of
the day when DST
is enabled is evaluated as 23:30 of the previous day.
</para>
+ <note>
+ <para>
+ As of PHP 5.1.0, this parameter became deprecated. As a result, the
+ new timezone handling features should be used instead.
+ </para>
+ </note>
</listitem>
</varlistentry>
</variablelist>
@@ -136,6 +143,10 @@
<entry>3.0.10</entry>
<entry>Added <parameter>is_dst</parameter> parameter</entry>
</row>
+ <row>
+ <entry>5.1.0</entry>
+ <entry>the <parameter>is_dst</parameter> parameter became
deprecated</entry>
+ </row>
</tbody>
</tgroup>
</informaltable>
http://cvs.php.net/diff.php/phpdoc/en/reference/datetime/functions/strtotime.xml?r1=1.14&r2=1.15&ty=u
Index: phpdoc/en/reference/datetime/functions/strtotime.xml
diff -u phpdoc/en/reference/datetime/functions/strtotime.xml:1.14
phpdoc/en/reference/datetime/functions/strtotime.xml:1.15
--- phpdoc/en/reference/datetime/functions/strtotime.xml:1.14 Thu Jun 23
15:38:38 2005
+++ phpdoc/en/reference/datetime/functions/strtotime.xml Sat Jul 30
14:14:12 2005
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.14 $ -->
+<!-- $Revision: 1.15 $ -->
<!-- splitted from ./en/functions/datetime.xml, last change in rev 1.8 -->
<refentry id="function.strtotime">
<refnamediv>
@@ -22,11 +22,17 @@
</simpara>
<para>
This function will use the <envar>TZ</envar> environment variable (if
- available) to calculate the timestamp. Since PHP 5.1.0 and if the
- <envar>TZ</envar> variable isn't set, the <link
- linkend="ini.date.timezone">date.timezone</link> ini configuration option
- will be used. If none of these are available, "GMT" is assumed.
+ available) to calculate the timestamp. Since PHP 5.1.0 there are easier
+ ways to define the timezone that is used across all date/time functions.
+ That process is explained in the
+ <function>date_default_timezone_get</function> function page.
</para>
+ <note>
+ <para>
+ If the number of the year is specified in a two digit format, the values
+ between 0-69 are mapped to 2000-2069 and 70-100 to 1970-2000.
+ </para>
+ </note>
</refsect1>
<refsect1 role="parameters">
@@ -79,8 +85,6 @@
<entry>5.1.0</entry>
<entry>
It now returns &false; on failure, instead of <literal>-1</literal>.
- Added the <link linkend="ini.date.timezone">date.timezone</link> ini
- option.
</entry>
</row>
</tbody>
http://cvs.php.net/co.php/phpdoc/en/reference/datetime/constants.xml?r=1.1&p=1
Index: phpdoc/en/reference/datetime/constants.xml
+++ phpdoc/en/reference/datetime/constants.xml
<?xml version='1.0' encoding='iso-8859-1'?>
<!-- $Revision: 1.1 $ -->
<section id="datetime.constants">
&reftitle.constants;
<para>
The following constants are defined since PHP 5.1.0 and they offer standard
date representations, which can be used along with the date format functions
(like <function>date</function> or <function>strftime</function>).
</para>
<variablelist>
<varlistentry>
<term>
<constant>DATE_ATOM</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
Atom
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>DATE_COOKIE</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
HTTP Cookies
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>DATE_ISO8601</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
ISO-8601
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>DATE_RFC822</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
RFC 822
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>DATE_RFC850</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
RFC 850
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>DATE_RFC1036</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
RFC 1036
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>DATE_RFC1123</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
RFC 1123
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>DATE_RFC2822</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
RFC 2822
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>DATE_RSS</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
RSS
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<constant>DATE_W3C</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
World Wide Web Consortium (W3C)
</simpara>
</listitem>
</varlistentry>
</variablelist>
</section>
<!-- 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:"../../../../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
-->
