Skip to content

[3.14] gh-124549: Document that strptime() uses the last directive when a time unit is over-specified (GH-125009) #159951

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Mariatta merged 1 commit into from
Oct 20, 2026
Merged

[3.14] gh-124549: Document that strptime() uses the last directive when a time unit is over-specified (GH-125009) #159951

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions Doc/library/datetime.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2703,6 +2703,13 @@ in the format string will be pulled from the default value.
the default year of 1900 is *not* a leap year. Always add a default leap
year to partial date strings before parsing.

.. note::
If a :meth:`~.datetime.strptime` format string contains more than
one directive for the same field, for example both ``%Y`` and ``%y``,
every directive must still match the input, but only the value of the
last one is used. For example, parsing ``200099`` with ``%Y%y`` gives
the year 1999. Repeating the same directive, like ``%Y%Y``, raises an error.

.. testsetup::

# doctest seems to turn the warning into an error which makes it
Expand Down
Loading