https://github.com/python/cpython/commit/05b04903a14279421ecdc6522b8202822de6ebb5
commit: 05b04903a14279421ecdc6522b8202822de6ebb5
branch: main
author: Serhiy Storchaka <[email protected]>
committer: serhiy-storchaka <[email protected]>
date: 2024-03-01T19:16:29+02:00
summary:
gh-116035: Document that both tzinfo and fold are ignored in comparisons if
tzinfo is the same (GH-116187)
This mostly restores information removed in
c12240ed28aac6494750e00143bc550c4d6d8ad1 (GH-114749).
files:
M Doc/library/datetime.rst
diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst
index 4602132f37f733..1905c9e1ca755d 100644
--- a/Doc/library/datetime.rst
+++ b/Doc/library/datetime.rst
@@ -1209,6 +1209,9 @@ Supported operations:
Naive and aware :class:`!datetime` objects are never equal.
+ If both comparands are aware, and have the same :attr:`!tzinfo` attribute,
+ the :attr:`!tzinfo` and :attr:`~.datetime.fold` attributes are ignored and
+ the base datetimes are compared.
If both comparands are aware and have different :attr:`~.datetime.tzinfo`
attributes, the comparison acts as comparands were first converted to UTC
datetimes except that the implementation never overflows.
@@ -1222,6 +1225,9 @@ Supported operations:
Order comparison between naive and aware :class:`.datetime` objects
raises :exc:`TypeError`.
+ If both comparands are aware, and have the same :attr:`!tzinfo` attribute,
+ the :attr:`!tzinfo` and :attr:`~.datetime.fold` attributes are ignored and
+ the base datetimes are compared.
If both comparands are aware and have different :attr:`~.datetime.tzinfo`
attributes, the comparison acts as comparands were first converted to UTC
datetimes except that the implementation never overflows.
@@ -1778,8 +1784,8 @@ Naive and aware :class:`!time` objects are never equal.
Order comparison between naive and aware :class:`!time` objects raises
:exc:`TypeError`.
-If both comparands are aware, and have
-the same :attr:`~.time.tzinfo` attribute, the common :attr:`!tzinfo` attribute
is
+If both comparands are aware, and have the same :attr:`~.time.tzinfo`
+attribute, the :attr:`!tzinfo` and :attr:`!fold` attributes are
ignored and the base times are compared. If both comparands are aware and
have different :attr:`!tzinfo` attributes, the comparands are first adjusted by
subtracting their UTC offsets (obtained from ``self.utcoffset()``).
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: [email protected]
