[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