bpo-45335: Add note to sqlite3 docs about "timestamp" converter (GH…

…-29200)
python · Oct 29, 2021 · 3877fc0 · 3877fc0
1 parent f0150ac
commit 3877fc0
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst
@@ -1095,6 +1095,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: