From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Mon, 29 Oct 2018 11:55:15 +0000 (-0700) Subject: bpo-27741: Better wording for datetime.strptime() (GH-9994) X-Git-Tag: v2.7.16rc1~98 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4ec427b005036dab0a380de20f31774394ca4dd6;p=thirdparty%2FPython%2Fcpython.git bpo-27741: Better wording for datetime.strptime() (GH-9994) (cherry picked from commit c0799ec973530ad2492bb1d6c7287ffc428f0348) Co-authored-by: Gus Goulart --- diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst index d2c1c563863f..1e575d5d572e 100644 --- a/Doc/library/datetime.rst +++ b/Doc/library/datetime.rst @@ -1594,7 +1594,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``