mirrors
/
django
mirror of https://github.com/django/django.git
1
0
Fork 0
Code Issues 24 Releases Wiki Activity

Fixed #35267 -- Clarified time zone topic for PostgreSQL in docs. 

The timezone documentation for Postgres mentions the behavior of
time zone conversion, but links to the wrong setting that controls the
behavior.

Postgres will not return datetimes in the time zone set by the
TIME_ZONE setting, but rather the time zone of the database connection,
which is defined by DATABASES.TIME_ZONE setting falling back to UTC.

This corrects the link in the documentation and adds note that there
are two distinct TIME_ZONE settings and the one most are familiar with
is not considered for PostgreSQL time zone conversion.
This commit is contained in:
Josh Smeaton 2024-03-05 20:34:14 +11:00 committed by Mariusz Felisiak
parent ab22b7c65f
commit 6e195b800a
1 changed files with 9 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
docs/topics/i18n/timezones.txt
View File

@ -393,9 +393,15 @@ UTC on storage, and from UTC to the connection's time zone on retrieval.
As a consequence, if you're using PostgreSQL, you can switch between ``USE_TZ
= False`` and ``USE_TZ = True`` freely. The database connection's time zone
will be set to :setting:`TIME_ZONE` or ``UTC`` respectively, so that Django
obtains correct datetimes in all cases. You don't need to perform any data
conversions.
will be set to :setting:`DATABASE-TIME_ZONE` or ``UTC`` respectively, so that
Django obtains correct datetimes in all cases. You don't need to perform any
data conversions.
.. admonition:: Time zone settings
The :setting:`time zone <DATABASE-TIME_ZONE>` configured for the connection
in the :setting:`DATABASES` setting is distinct from the general
:setting:`TIME_ZONE` setting.
Other databases
~~~~~~~~~~~~~~~