Skip to content

Conversation

@gpshead
Copy link
Member

@gpshead gpshead commented Dec 21, 2025

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/

gpshead and 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
@gpshead gpshead requested a review from pganssle as a code owner December 21, 2025 06:57
@gpshead gpshead added the docs Documentation in the Doc dir label Dec 21, 2025
@gpshead gpshead requested a review from abalkin as a code owner December 21, 2025 06:57
@github-project-automation github-project-automation bot moved this to Todo in Docs PRs Dec 21, 2025
@gpshead gpshead 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.13 Dec 21, 2025
30 checks passed
@github-project-automation github-project-automation bot moved this from Todo to Done in Docs PRs Dec 21, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation in the Doc dir skip news

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant