[Python-checkins] datetime.rst: improve combine() docs (#101338)

abalkin webhook-mailer at python.org
Thu Jan 26 02:25:50 EST 2023


https://github.com/python/cpython/commit/f5ad63f79af3a5876f90b409d0c8402fa54e878a
commit: f5ad63f79af3a5876f90b409d0c8402fa54e878a
branch: main
author: John Belmonte <john at neggie.net>
committer: abalkin <abalkin at users.noreply.github.com>
date: 2023-01-26T11:25:43+04:00
summary:

datetime.rst: improve combine() docs (#101338)

The explanation on handling of datetime as the date arg was confusingly mixed with an unrelated
item, and lacked proper arg name formatting.

files:
M Doc/library/datetime.rst

diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst
index eba8824f8351..ebb5f319efda 100644
--- a/Doc/library/datetime.rst
+++ b/Doc/library/datetime.rst
@@ -982,12 +982,11 @@ Other constructors, all class methods:
    are equal to the given :class:`.time` object's. If the *tzinfo*
    argument is provided, its value is used to set the :attr:`.tzinfo` attribute
    of the result, otherwise the :attr:`~.time.tzinfo` attribute of the *time* argument
-   is used.
+   is used.  If the *date* argument is a :class:`.datetime` object, its time components
+   and :attr:`.tzinfo` attributes are ignored.
 
    For any :class:`.datetime` object *d*,
-   ``d == datetime.combine(d.date(), d.time(), d.tzinfo)``. If date is a
-   :class:`.datetime` object, its time components and :attr:`.tzinfo` attributes
-   are ignored.
+   ``d == datetime.combine(d.date(), d.time(), d.tzinfo)``.
 
    .. versionchanged:: 3.6
       Added the *tzinfo* argument.



More information about the Python-checkins mailing list