[3.14] gh-70647: Better promote how to safely parse yearless dates in datetime. (GH-116179) by miss-islington · Pull Request #143037 · python/cpython

@gpshead @miss-islington

…datetime. (pythonGH-116179)

* pythongh-70647: Better promote how to safely parse yearless dates in datetime.

Every four years people encounter this because it just isn't obvious.
This moves the footnote up to a note with a code example.

We'd love to change the default year value for datetime but doing
that could have other consequences for existing code.  This documented
workaround *always* works.

* doctest code within note is bad, dedent.

* Update to match the error message.

* remove no longer referenced footnote

* ignore the warning in the doctest

* use Petr's suggestion for the docs to hide the warning processing

* cover date.strptime (3.14) as well
(cherry picked from commit b8d3fdd)

Co-authored-by: Gregory P. Smith <68491+gpshead@users.noreply.github.com>

This was referenced

Dec 21, 2025