cvs: phpdoc /en/reference/datetime/functions strftime.xml

pollita Tue Dec 31 14:18:14 2002 EDT Modified files: /phpdoc/en/reference/datetime/functions strftime.xml Log: Per multiple "bug" reports of misunderstanding use of %G and %V, added example showing week numbers for 2002/2003 (week forward) and 2004/2005 (week backward). Index: phpdoc/en/reference/datetime/functions/strftime.xml diff -u phpdoc/en/reference/datetime/functions/strftime.xml:1.4 phpdoc/en/reference/datetime/functions/strftime.xml:1.5 --- phpdoc/en/reference/datetime/functions/strftime.xml:1.4 Tue Nov 26 15:41:08 2002 +++ phpdoc/en/reference/datetime/functions/strftime.xml Tue Dec 31 14:18:14 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.strftime"> <refnamediv> @@ -242,7 +242,7 @@ </para> </note> <example> - <title><function>strftime</function> example</title> + <title><function>strftime</function> locale examples</title> <programlisting role="php"> <![CDATA[ setlocale (LC_TIME, "C"); @@ -258,6 +258,66 @@ </example> This example works if you have the respective locales installed in your system. + <note> + <simpara> + %G and %V, which are based on ISO 8601:1988 week numbers can + give unexpected (albiet correct) results if the numbering system + is not thoroughly understood. See %V above and example below. + </simpara> + </note> + <example> + <title>ISO 8601:1988 week number example</title> + <programlisting role="php"> +<![CDATA[ +<?php +/* December 2002 / January 2003 +ISOWk M Tu W Thu F Sa Su +----- ---------------------------- +51 16 17 18 19 20 21 22 +52 23 24 25 26 27 28 29 +1 30 31 1 2 3 4 5 +2 6 7 8 9 10 11 12 +3 13 14 15 16 17 18 19 */ + +// Outputs: 12/28/2002 - %V,%G,%Y = 52,2002,2002 +print "12/28/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/28/2002")) . "\n"; + +// Outputs: 12/30/2002 - %V,%G,%Y = 1,2003,2002 +print "12/30/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/30/2002")) . "\n"; + +// Outputs: 1/3/2003 - %V,%G,%Y = 1,2003,2003 +print "1/3/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2003")) . "\n"; + +// Outputs: 1/10/2003 - %V,%G,%Y = 2,2003,2003 +print "1/10/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/10/2003")) . "\n"; + + + +/* December 2004 / January 2005 +ISOWk M Tu W Thu F Sa Su +----- ---------------------------- +51 13 14 15 16 17 18 19 +52 20 21 22 23 24 25 26 +53 27 28 29 30 31 1 2 +1 3 4 5 6 7 8 9 +2 10 11 12 13 14 15 16 */ + +// Outputs: 12/23/2004 - %V,%G,%Y = 52,2004,2004 +print "12/23/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/23/2004")) . "\n"; + +// Outputs: 12/31/2004 - %V,%G,%Y = 53,2004,2004 +print "12/31/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/31/2004")) . "\n"; + +// Outputs: 1/2/2005 - %V,%G,%Y = 53,2004,2005 +print "1/2/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/2/2005")) . "\n"; + +// Outputs: 1/3/2005 - %V,%G,%Y = 1,2005,2005 +print "1/3/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2005")) . "\n"; + +?> +]]> + </programlisting> + </example> </para> <para> See also <function>setlocale</function> and