https://github.com/python/cpython/commit/a8a1df05f76a2fb34c1ce8167fd24484a70d48b2
commit: a8a1df05f76a2fb34c1ce8167fd24484a70d48b2
branch: 3.12
author: Miss Islington (bot) <31488909+miss-isling...@users.noreply.github.com>
committer: serhiy-storchaka <storch...@gmail.com>
date: 2024-02-01T19:34:08+02:00
summary:
[3.12] gh-105031: Clarify datetime documentation for ISO8601 (GH-105049)
(GH-114866)
(cherry picked from commit e9dab656380ec03d628979975646748330b76b9b)
Co-authored-by: Nicholas Hollander
<31573882+nhhollan...@users.noreply.github.com>
files:
M Doc/library/datetime.rst
diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst
index decb7fe304b91a..ab8f225fc6e202 100644
--- a/Doc/library/datetime.rst
+++ b/Doc/library/datetime.rst
@@ -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')
@@ -1014,8 +1022,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::
_______________________________________________
Python-checkins mailing list -- python-checkins@python.org
To unsubscribe send an email to python-checkins-le...@python.org
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: arch...@mail-archive.com
