svn: /phpdoc/en/trunk/reference/datetime/functions/ strptime.xml

aharvey Fri, 20 Aug 2010 05:45:06 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=302528 Log: Fix doc bug #52642 (You have mixed up two values in one of the tables) by adding a note to the strptime() manual page explaining how OS dependent it is, suggesting date_parse_from_format() as an alternative, and refining the parameter descriptions. Bug: http://bugs.php.net/52642 (Assigned) You have mixed up two values in one of the tables Changed paths: U phpdoc/en/trunk/reference/datetime/functions/strptime.xml Modified: phpdoc/en/trunk/reference/datetime/functions/strptime.xml =================================================================== --- phpdoc/en/trunk/reference/datetime/functions/strptime.xml 2010-08-20 05:37:22 UTC (rev 302527) +++ phpdoc/en/trunk/reference/datetime/functions/strptime.xml 2010-08-20 05:45:06 UTC (rev 302528) @@ -32,7 +32,7 @@ <term><parameter>date</parameter> (<type>string</type>)</term> <listitem> <para> - The string to parse (e.g. returned from <function>strftime</function>) + The string to parse (e.g. returned from <function>strftime</function>). </para> </listitem> </varlistentry> @@ -41,7 +41,11 @@ <listitem> <para> The format used in <parameter>date</parameter> (e.g. the same as - used in <function>strftime</function>). + used in <function>strftime</function>). Note that some of the format + options available to <function>strftime</function> may not have any + effect within <function>strptime</function>; the exact subset that are + supported will vary based on the operating system and C library in + use. </para> <para> For more information about the format options, read the @@ -159,6 +163,15 @@ &note.no-windows; <note> <para> + Internally, this function calls the <literal>strptime()</literal> + function provided by the system's C library. This function can exhibit + noticeably different behaviour across different operating systems. The + use of <function>date_parse_from_format</function>, which does not + suffer from these issues, is recommended on PHP 5.3.0 and later. + </para> + </note> + <note> + <para> <literal>"tm_sec"</literal> includes any leap seconds (currently upto 2 a year). For more information on leap seconds, see the <link xlink:href="&url.wiki.leap-seconds;">Wikipedia article