mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-10-01 04:42:10 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 6

[3.12] gh-105031: Clarify datetime documentation for ISO8601 (GH-105049) (GH-114866)

Browse source 
(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:34:08 +01:00 • committed by GitHub
parent 5c5ecc8521
commit a8a1df05f7
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 15 additions and 3 deletions
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) .. classmethod:: date.fromisoformat(date_string)
Return a :class:`date` corresponding to a *date_string* given in any valid 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 >>> from datetime import date
>>> date.fromisoformat('2019-12-04') >>> date.fromisoformat('2019-12-04')
@ -1014,8 +1022,12 @@ Other constructors, all class methods:
1. Time zone offsets may have fractional seconds. 1. Time zone offsets may have fractional seconds.
2. The ``T`` separator may be replaced by any single unicode character. 2. The ``T`` separator may be replaced by any single unicode character.
3. Ordinal dates are not currently supported. 3. Fractional hours and minutes are not supported.
4. 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:: Examples::