Skip to content

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

Merged
gpshead merged 2 commits into
python:3.13from
gpshead:backport-b8d3fdd-3.13
Dec 21, 2025
Merged

[3.13] gh-70647: Better promote how to safely parse yearless dates in datetime. (GH-116179)#143038
gpshead merged 2 commits into
python:3.13from
gpshead:backport-b8d3fdd-3.13

Conversation

@gpshead

@gpsheadgpshead commented Dec 21, 2025

Copy link
Copy Markdown
Member

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

(cherry picked from commit b8d3fdd)


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

gpsheadand others added 2 commits December 21, 2025 06:54
…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
@gpsheadgpshead added the docs Documentation in the Doc dir label Dec 21, 2025
@gpsheadgpshead self-assigned this Dec 21, 2025
@gpshead
gpshead enabled auto-merge (squash) December 21, 2025 07:01
@gpshead
gpshead merged commit 9b7a628 into python:3.13Dec 21, 2025
30 checks passed
@github-project-automationgithub-project-automationBot moved this from Todo to Done in Docs PRsDec 21, 2025
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.

1 participant

@gpshead