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

From: Date: Fri, 26 Sep 2014 05:03:01 +0000
Subject: Doc #68102 [NEW]: Incorrect / misleading description of the ISO-8601 week-numbering year
Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-11512@lists.php.net to get a copy of this message
From:             ryan dot y dot rhee at gmail dot com
Operating system: Irrelevant
PHP version:      Irrelevant
Package:          Documentation problem
Bug Type:         Documentation Problem
Bug description:Incorrect / misleading description of the ISO-8601 week-numbering year

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 bug report at https://bugs.php.net/bug.php?id=68102&edit=1
-- 
Try a snapshot (PHP 5.4):   https://bugs.php.net/fix.php?id=68102&r=trysnapshot54
Try a snapshot (PHP 5.5):   https://bugs.php.net/fix.php?id=68102&r=trysnapshot55
Try a snapshot (trunk):     https://bugs.php.net/fix.php?id=68102&r=trysnapshottrunk
Fixed in SVN:               https://bugs.php.net/fix.php?id=68102&r=fixed
Fixed in release:           https://bugs.php.net/fix.php?id=68102&r=alreadyfixed
Need backtrace:             https://bugs.php.net/fix.php?id=68102&r=needtrace
Need Reproduce Script:      https://bugs.php.net/fix.php?id=68102&r=needscript
Try newer version:          https://bugs.php.net/fix.php?id=68102&r=oldversion
Not developer issue:        https://bugs.php.net/fix.php?id=68102&r=support
Expected behavior:          https://bugs.php.net/fix.php?id=68102&r=notwrong
Not enough info:            https://bugs.php.net/fix.php?id=68102&r=notenoughinfo
Submitted twice:            https://bugs.php.net/fix.php?id=68102&r=submittedtwice
register_globals:           https://bugs.php.net/fix.php?id=68102&r=globals
PHP 4 support discontinued: https://bugs.php.net/fix.php?id=68102&r=php4
Daylight Savings:           https://bugs.php.net/fix.php?id=68102&r=dst
IIS Stability:              https://bugs.php.net/fix.php?id=68102&r=isapi
Install GNU Sed:            https://bugs.php.net/fix.php?id=68102&r=gnused
Floating point limitations: https://bugs.php.net/fix.php?id=68102&r=float
No Zend Extensions:         https://bugs.php.net/fix.php?id=68102&r=nozend
MySQL Configuration Error:  https://bugs.php.net/fix.php?id=68102&r=mysqlcfg



Thread (2 messages)

« previous php.doc.bugs (#11512) next »