Skip to content

docs: explain JSON datetime range workarounds - #328

Merged
phanak-sap merged 1 commit into
SAP:masterfrom
UmutAlisoglu:codex/document-datetime-workarounds
Oct 29, 2026
Merged

phanak-sap merged 1 commit into
SAP:masterfrom
UmutAlisoglu:codex/document-datetime-workarounds

Conversation

@UmutAlisoglu

Copy link
Copy Markdown
Contributor

Fixes #178.

Document both JSON datetime range workarounds in the advanced guide: defaults, independent flags, valid millisecond boundaries, exact fallback dates, timezone retention, and process-wide scope. Include runnable examples and explain that the maximum fallback is midnight on December 31, 9999, rather than datetime.max. Clarify that malformed strings and URL literals are outside these workarounds.

Validation:

  • Executed both documented code blocks against the current model and checked the two results and strict decoding with the flags disabled; restored original settings afterward.
  • Full suite: 314 passed, 93% coverage. Pylint 10/10, Flake8 and diff checks pass.
  • Fresh Sphinx HTML build completes with the same five existing warnings before/after (language=None, missing _static, two vendors.rst underlines and its missing toctree entry). Strict -W is not green; this change adds no warning.

Documentation only; no decoder behavior changes. Independent of #327.

Signed off. AI assistance was used to draft and verify this documentation.

Comment thread CHANGELOG.md Resolved
Signed-off-by: Umut Alisoglu <umutalisoglu@gmail.com>
@UmutAlisoglu
UmutAlisoglu force-pushed the codex/document-datetime-workarounds branch from d4e194a to 2474170 Compare October 29, 2026 17:53
@phanak-sap
phanak-sap merged commit 22a772c into SAP:master Oct 29, 2026
42 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document FIX_SCREWED_UP_MINIMAL_DATETIME_VALUE/FIX_SCREWED_UP_MAXIMUM_DATETIME_VALUE

2 participants