You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/ref/settings.txt
+34-20Lines changed: 34 additions & 20 deletions
Original file line number
Diff line number
Diff line change
@@ -1505,28 +1505,42 @@ TIME_ZONE
1505
1505
1506
1506
Default: ``'America/Chicago'``
1507
1507
1508
-
A string representing the time zone for this installation. `See available choices`_.
1509
-
(Note that list of available choices lists more than one on the same line;
1510
-
you'll want to use just one of the choices for a given time zone. For instance,
1511
-
one line says ``'Europe/London GB GB-Eire'``, but you should use the first bit
1512
-
of that -- ``'Europe/London'`` -- as your ``TIME_ZONE`` setting.)
1513
-
1514
-
Note that this is the time zone to which Django will convert all dates/times --
1515
-
not necessarily the timezone of the server. For example, one server may serve
1516
-
multiple Django-powered sites, each with a separate time-zone setting.
1517
-
1518
-
Normally, Django sets the ``os.environ['TZ']`` variable to the time zone you
1519
-
specify in the ``TIME_ZONE`` setting. Thus, all your views and models will
1520
-
automatically operate in the correct time zone. However, if you're manually
1521
-
:ref:`manually configuring settings
1522
-
<settings-without-django-settings-module>`, Django will *not* touch the ``TZ``
1523
-
environment variable, and it'll be up to you to ensure your processes are
1524
-
running in the correct environment.
1508
+
.. versionchanged:: 1.2
1509
+
``None`` was added as an allowed value.
1510
+
1511
+
A string representing the time zone for this installation, or
1512
+
``None``. `See available choices`_. (Note that list of available
1513
+
choices lists more than one on the same line; you'll want to use just
1514
+
one of the choices for a given time zone. For instance, one line says
1515
+
``'Europe/London GB GB-Eire'``, but you should use the first bit of
1516
+
that -- ``'Europe/London'`` -- as your ``TIME_ZONE`` setting.)
1517
+
1518
+
Note that this is the time zone to which Django will convert all
1519
+
dates/times -- not necessarily the timezone of the server. For
1520
+
example, one server may serve multiple Django-powered sites, each with
1521
+
a separate time-zone setting.
1522
+
1523
+
Normally, Django sets the ``os.environ['TZ']`` variable to the time
1524
+
zone you specify in the ``TIME_ZONE`` setting. Thus, all your views
1525
+
and models will automatically operate in the correct time zone.
1526
+
However, Django won't set the ``TZ`` environment variable under the
1527
+
following conditions:
1528
+
1529
+
* If you're using the manual configuration option as described in
1530
+
:ref:`manually configuring settings
1531
+
<settings-without-django-settings-module>`, or
1532
+
1533
+
* If you specify ``TIME_ZONE = None``. This will cause Django to fall
1534
+
back to using the system timezone.
1535
+
1536
+
If Django doesn't set the ``TZ`` environment variable, it's up to you
1537
+
to ensure your processes are running in the correct environment.
1525
1538
1526
1539
.. note::
1527
-
Django cannot reliably use alternate time zones in a Windows environment.
1528
-
If you're running Django on Windows, this variable must be set to match the
1529
-
system timezone.
1540
+
Django cannot reliably use alternate time zones in a Windows
1541
+
environment. If you're running Django on Windows, this variable
1542
+
must be set to match the system timezone.
1543
+
1530
1544
1531
1545
.. _See available choices: http://www.postgresql.org/docs/8.1/static/datetime-keywords.html#DATETIME-TIMEZONE-SET-TABLE
0 commit comments