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