betz Thu Aug 19 07:05:41 2004 EDT
Modified files:
/phpdoc/en/reference/datetime/functions mktime.xml
Log:
move para about invalid times with dst.
http://cvs.php.net/diff.php/phpdoc/en/reference/datetime/functions/mktime.xml?r1=1.12&r2=1.13&ty=u
Index: phpdoc/en/reference/datetime/functions/mktime.xml
diff -u phpdoc/en/reference/datetime/functions/mktime.xml:1.12
phpdoc/en/reference/datetime/functions/mktime.xml:1.13
--- phpdoc/en/reference/datetime/functions/mktime.xml:1.12 Sat Aug 7 10:26:50
2004
+++ phpdoc/en/reference/datetime/functions/mktime.xml Thu Aug 19 07:05:41 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.12 $ -->
+<!-- $Revision: 1.13 $ -->
<!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 -->
<refentry id="function.mktime">
<refnamediv>
@@ -38,23 +38,23 @@
</para>
<para>
<parameter>is_dst</parameter> can be set to 1 if the time is
- during daylight savings time, 0 if it is not, or -1 (the default)
+ during daylight savings time (DST), 0 if it is not, or -1 (the default)
if it is unknown whether the time is within daylight savings time
or not. If it's unknown, PHP tries to figure it out itself. This can
cause unexpected (but not incorrect) results.
</para>
+ <para>
+ Some times are invalid if <parameter>is_dst</parameter> is set to 1. If
+ DST is enabled in e.g. 2:00, all times between 2:00 and 3:00 are invalid
+ and <function>mktime</function> returns an undefined (usually negative)
+ value. 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>
<parameter>is_dst</parameter> was added in 3.0.10.
</para>
</note>
- <para>
- Some times are invalid if DST is on. If DST is enabled in e.g. 2:00, all
- times between 2:00 and 3:00 are invalid and <function>mktime</function>
- returns undefined (usually negative) value. Some systems (e.g. Solaris 8)
- enable DST in midnight so time 0:30 of the day when DST is enabled is
- evaluated as 23:30 of the previous day.
- </para>
<para>
<function>mktime</function> is useful for doing date arithmetic
and validation, as it will automatically calculate the correct