Doc #68102 [Opn->Csd]: Incorrect / misleading description of the ISO-8601 week-numbering year

Edit report at https://bugs.php.net/bug.php?id=68102&edit=1 ID: 68102 Updated by: cmb@php.net Reported by: ryan dot y dot rhee at gmail dot com Summary: Incorrect / misleading description of the ISO-8601 week-numbering year -Status: Open +Status: Closed Type: Documentation Problem -Package: Documentation problem +Package: Date/time related Operating System: Irrelevant PHP Version: Irrelevant -Assigned To: +Assigned To: cmb Block user comment: N Private report: N New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. Previous Comments: ------------------------------------------------------------------------ [2016-07-25 15:36:11] cmb@php.net Automatic comment from SVN on behalf of cmb Revision: http://svn.php.net/viewvc/?view=revision&revision=339714 Log: Fix #68102: Incorrect / misleading description of the ISO-8601 week-numbering year ------------------------------------------------------------------------ [2014-09-26 05:02:59] ryan dot y dot rhee at gmail dot com Description: ------------ --- From manual page: http://www.php.net/function.date --- The explanation for the date format specifier o is as follows: > ISO-8601 year number. This has the same value as Y, except that if the ISO week number (W) > belongs to the previous or next year, that year is used instead. (added in PHP 5.1.0) That seems misleading. o is used as the _ISO week-numbering year_ which is different from the normal year that ISO-8601 uses. Unless one is using numbered weeks and day of the week to represent a date, the regular year is ISO-8601 compliant. However, calling this the "ISO-8601 year number" makes it seem like those who wish to conform to ISO-8601 should use o, which is incorrect. ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=68102&edit=1