mirrors
/
cpython
mirror of https://github.com/python/cpython.git
2
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

[3.11] gh-105031: Clarify datetime documentation for ISO8601 (GH-105049) (GH-114867) 

(cherry picked from commit e9dab65638)

Co-authored-by: Nicholas Hollander <31573882+nhhollander@users.noreply.github.com>
This commit is contained in:
Miss Islington (bot) 2024-02-01 18:33:55 +01:00 committed by GitHub
parent e3458aa431
commit 3acab9a676
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 15 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
Doc/library/datetime.rst
View File

@ -536,7 +536,15 @@ Other constructors, all class methods:
.. classmethod:: date.fromisoformat(date_string)
Return a :class:`date` corresponding to a *date_string* given in any valid
ISO 8601 format, except ordinal dates (e.g. ``YYYY-DDD``)::
ISO 8601 format, with the following exceptions:
1. Reduced precision dates are not currently supported (``YYYY-MM``,
``YYYY``).
2. Extended date representations are not currently supported
(``±YYYYYY-MM-DD``).
3. Ordinal dates are not currently supported (``YYYY-OOO``).
Examples::
>>> from datetime import date
>>> date.fromisoformat('2019-12-04')
@ -1006,8 +1014,12 @@ Other constructors, all class methods:
1. Time zone offsets may have fractional seconds.
2. The ``T`` separator may be replaced by any single unicode character.
3. Ordinal dates are not currently supported.
4. Fractional hours and minutes are not supported.
3. Fractional hours and minutes are not supported.
4. Reduced precision dates are not currently supported (``YYYY-MM``,
``YYYY``).
5. Extended date representations are not currently supported
(``±YYYYYY-MM-DD``).
6. Ordinal dates are not currently supported (``YYYY-OOO``).
Examples::