[Python-checkins] bpo-45335: Add note to `sqlite3` docs about "timestamp" converter (GH-29200) (GH-29320)

[ambv]

https://github.com/python/cpython/commit/e1560313d4d9bff8eba0f851ef325f7ee19f7ba9
commit: e1560313d4d9bff8eba0f851ef325f7ee19f7ba9
branch: 3.9
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: ambv <lukasz at langa.pl>
date: 2021-10-29T22:42:38+02:00
summary:

bpo-45335: Add note to `sqlite3` docs about "timestamp" converter (GH-29200) (GH-29320)

(cherry picked from commit 3877fc02f7a8801ba5ce0e94b6075b3fdd9778d0)

Co-authored-by: Ian Fisher <ian at iafisher.com>

files:
M Doc/library/sqlite3.rst

diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst
index b9436daaebb4b..b24a2f0985489 100644
--- a/Doc/library/sqlite3.rst
+++ b/Doc/library/sqlite3.rst
@@ -1062,6 +1062,12 @@ If a timestamp stored in SQLite has a fractional part longer than 6
 numbers, its value will be truncated to microsecond precision by the
 timestamp converter.
 
+.. note::
+
+   The default "timestamp" converter ignores UTC offsets in the database and
+   always returns a naive :class:`datetime.datetime` object. To preserve UTC
+   offsets in timestamps, either leave converters disabled, or register an
+   offset-aware converter with :func:`register_converter`.
 
 .. _sqlite3-controlling-transactions: