docs(sql): document timestamp without time zone decoded as UTC (fixes #39879) - #39911
docs(sql): document timestamp without time zone decoded as UTC (fixes #39879)#39911deepshekhardas wants to merge 1 commit into
Conversation
…ven-sh#39879) PostgreSQL timestamp (OID 1114) is decoded as UTC so text and binary paths agree and bound Date round-trips regardless of host timezone. This differs from node-postgres/postgres.js/PGlite which decode as local time. Add PostgreSQL-specific note with callout.
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: ASSERTIVE Plan: Pro Plus Run ID: 📒 Files selected for processing (1)
Included review availability: Your plan provides up to 10 included reviews per hour; 9 remain after this review. WalkthroughChangesPostgreSQL timestamp documentation
Suggested reviewers: Merge Risk: ⚪ Minimal · up to This change only clarifies PostgreSQL timestamp decoding behavior in the documentation and introduces no production code or runtime behavior changes; no actionable merge-blocking risk remains. 🚥 Pre-merge checks | ✅ 4✅ Passed checks (4 passed)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
|
Thank you for the PR, and for the clear write-up of the facts. #39879 is documented by #39881, which was opened a few hours earlier. After review, that PR now adds a top-level "Dates and time zones" section, so the rule appears in the page table of contents and is stated once for PostgreSQL and MySQL. The MySQL note links to it. I folded the extra facts from this PR into #39881 (OID 1114, text and binary queries agree, PGlite). Commit b187c78 carries a I am closing this PR in favor of #39881 to keep one change per issue. If you see a gap in the wording there, please comment on #39881. |
Fixes #39879
PostgreSQL imestamp without time zone (OID 1114) is decoded as UTC so text and binary paths agree and a bound Date round-trips regardless of host timezone. This differs from
ode-postgres/postgres.js/PGlite which decode as local time.
Previously the behavior was documented only in the MySQL section at docs/runtime/sql.mdx:1370, inside a trailing clause. A PostgreSQL user had no reason to read that section and the PostgreSQL docs said nothing, leading to silent offset shifts when migrating from pg.
Adds a dedicated imestamp without time zone note under PostgreSQL-Specific Features.