summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2018-10-29 11:54:54 (GMT)
committerGitHub <noreply@github.com>2018-10-29 11:54:54 (GMT)
commit0a53a067dc4eb86ecf94c50582b3e22359c601a9 (patch)
treefb569c6b75a21472ba020441583f71bd566acb03 /Doc/library
parent86a0f222cedc580413dd25d3565beef51ee24e5b (diff)
downloadcpython-0a53a067dc4eb86ecf94c50582b3e22359c601a9.zip
cpython-0a53a067dc4eb86ecf94c50582b3e22359c601a9.tar.gz
cpython-0a53a067dc4eb86ecf94c50582b3e22359c601a9.tar.bz2
bpo-27741: Better wording for datetime.strptime() (GH-9994)
(cherry picked from commit c0799ec973530ad2492bb1d6c7287ffc428f0348) Co-authored-by: Gus Goulart <augusto@goulart.me>
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/datetime.rst4
1 files changed, 3 insertions, 1 deletions
diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst
index 26cb90b..f2bdf8d 100644
--- a/Doc/library/datetime.rst
+++ b/Doc/library/datetime.rst
@@ -1944,7 +1944,9 @@ although not all objects support a :meth:`timetuple` method.
Conversely, the :meth:`datetime.strptime` class method creates a
:class:`.datetime` object from a string representing a date and time and a
corresponding format string. ``datetime.strptime(date_string, format)`` is
-equivalent to ``datetime(*(time.strptime(date_string, format)[0:6]))``.
+equivalent to ``datetime(*(time.strptime(date_string, format)[0:6]))``, except
+when the format includes sub-second components or timezone offset information,
+which are supported in ``datetime.strptime`` but are discarded by ``time.strptime``.
For :class:`.time` objects, the format codes for year, month, and day should not
be used, as time objects have no such values. If they're used anyway, ``1900``