Skip to content

[3.14] gh-70647: Better promote how to safely parse yearless dates in datetime. (GH-116179) - #143037

Merged
gpshead merged 1 commit into
python:3.14from
miss-islington:backport-b8d3fdd-3.14
Dec 21, 2025
Merged

[3.14] gh-70647: Better promote how to safely parse yearless dates in datetime. (GH-116179)#143037
gpshead merged 1 commit into
python:3.14from
miss-islington:backport-b8d3fdd-3.14

Conversation

@miss-islington

@miss-islingtonmiss-islington commented Dec 21, 2025

Copy link
Copy Markdown
Contributor

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


📚 Documentation preview 📚: https://cpython-previews--143037.org.readthedocs.build/

…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>
@bedevere-appbedevere-appBot added docs Documentation in the Doc dir skip news labels Dec 21, 2025
@gpshead
gpshead enabled auto-merge (squash) December 21, 2025 06:51
@gpshead
gpshead merged commit 362d11e into python:3.14Dec 21, 2025
36 checks passed
@github-project-automationgithub-project-automationBot moved this from Todo to Done in Docs PRsDec 21, 2025
@miss-islington
miss-islington deleted the backport-b8d3fdd-3.14 branch January 2, 2026 18:08
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docsDocumentation in the Doc dirskip news

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants

@miss-islington@gpshead