diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/internals/deprecation.txt | 3 | ||||
| -rw-r--r-- | docs/ref/settings.txt | 4 | ||||
| -rw-r--r-- | docs/releases/4.0.txt | 14 | ||||
| -rw-r--r-- | docs/topics/i18n/timezones.txt | 15 |
4 files changed, 31 insertions, 5 deletions
diff --git a/docs/internals/deprecation.txt b/docs/internals/deprecation.txt index da15e4871e..1b5eb35769 100644 --- a/docs/internals/deprecation.txt +++ b/docs/internals/deprecation.txt @@ -21,6 +21,9 @@ details on these changes. * The undocumented ``django.utils.datetime_safe`` module will be removed. +* The default value of the ``USE_TZ`` setting will change from ``False`` to + ``True``. + .. _deprecation-removed-in-4.1: 4.1 diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index 6a568ea9b7..e6eee7d6bb 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -2809,6 +2809,10 @@ See also :setting:`DECIMAL_SEPARATOR`, :setting:`NUMBER_GROUPING` and Default: ``False`` +.. note:: + + In Django 5.0, the default value will change from ``False`` to ``True``. + A boolean that specifies if datetimes will be timezone-aware by default or not. If this is set to ``True``, Django will use timezone-aware datetimes internally. diff --git a/docs/releases/4.0.txt b/docs/releases/4.0.txt index 3168200070..207c6af5f6 100644 --- a/docs/releases/4.0.txt +++ b/docs/releases/4.0.txt @@ -431,6 +431,20 @@ Miscellaneous Features deprecated in 4.0 ========================== +Time zone support +----------------- + +In order to follow good practice, the default value of the :setting:`USE_TZ` +setting will change from ``False`` to ``True``, and time zone support will be +enabled by default, in Django 5.0. + +Note that the default :file:`settings.py` file created by +:djadmin:`django-admin startproject <startproject>` includes +:setting:`USE_TZ = True <USE_TZ>` since Django 1.4. + +You can set ``USE_TZ`` to ``False`` in your project settings before then to +opt-out. + Miscellaneous ------------- diff --git a/docs/topics/i18n/timezones.txt b/docs/topics/i18n/timezones.txt index e95b7a29de..7517ae47fc 100644 --- a/docs/topics/i18n/timezones.txt +++ b/docs/topics/i18n/timezones.txt @@ -26,11 +26,16 @@ to this problem is to use UTC in the code and use local time only when interacting with end users. Time zone support is disabled by default. To enable it, set :setting:`USE_TZ = -True <USE_TZ>` in your settings file. By default, time zone support uses pytz_, -which is installed when you install Django; Django also supports the use of -other time zone implementations like :mod:`zoneinfo` by passing -:class:`~datetime.tzinfo` objects directly to functions in -:mod:`django.utils.timezone`. +True <USE_TZ>` in your settings file. + +.. note:: + + In Django 5.0, time zone support will be enabled by default. + +By default, time zone support uses pytz_, which is installed when you install +Django; Django also supports the use of other time zone implementations like +:mod:`zoneinfo` by passing :class:`~datetime.tzinfo` objects directly to +functions in :mod:`django.utils.timezone`. .. versionchanged:: 3.2 |