Fixed #30733 -- Doc'd that datetime lookups require time zone definitions in the database.

Note was missing for date, year, iso_year, week, time, hour, minute,
and second lookups.
This commit is contained in:
Andrew 2019-08-27 17:37:24 -04:00 committed by Mariusz Felisiak
parent dba749917f
commit 29adcd215f
1 changed files with 20 additions and 12 deletions

View File

@ -2969,7 +2969,8 @@ Example::
implementation of the relevant query varies among different database engines.) implementation of the relevant query varies among different database engines.)
When :setting:`USE_TZ` is ``True``, fields are converted to the current time When :setting:`USE_TZ` is ``True``, fields are converted to the current time
zone before filtering. zone before filtering. This requires :ref:`time zone definitions in the
database <database-time-zone-definitions>`.
.. fieldlookup:: year .. fieldlookup:: year
@ -2994,7 +2995,8 @@ SQL equivalent:
(The exact SQL syntax varies for each database engine.) (The exact SQL syntax varies for each database engine.)
When :setting:`USE_TZ` is ``True``, datetime fields are converted to the When :setting:`USE_TZ` is ``True``, datetime fields are converted to the
current time zone before filtering. current time zone before filtering. This requires :ref:`time zone definitions
in the database <database-time-zone-definitions>`.
.. fieldlookup:: iso_year .. fieldlookup:: iso_year
@ -3014,7 +3016,8 @@ Example::
(The exact SQL syntax varies for each database engine.) (The exact SQL syntax varies for each database engine.)
When :setting:`USE_TZ` is ``True``, datetime fields are converted to the When :setting:`USE_TZ` is ``True``, datetime fields are converted to the
current time zone before filtering. current time zone before filtering. This requires :ref:`time zone definitions
in the database <database-time-zone-definitions>`.
.. fieldlookup:: month .. fieldlookup:: month
@ -3088,8 +3091,9 @@ Example::
(No equivalent SQL code fragment is included for this lookup because (No equivalent SQL code fragment is included for this lookup because
implementation of the relevant query varies among different database engines.) implementation of the relevant query varies among different database engines.)
When :setting:`USE_TZ` is ``True``, fields are converted to the current time When :setting:`USE_TZ` is ``True``, datetime fields are converted to the
zone before filtering. current time zone before filtering. This requires :ref:`time zone definitions
in the database <database-time-zone-definitions>`.
.. fieldlookup:: week_day .. fieldlookup:: week_day
@ -3155,7 +3159,8 @@ Example::
implementation of the relevant query varies among different database engines.) implementation of the relevant query varies among different database engines.)
When :setting:`USE_TZ` is ``True``, fields are converted to the current time When :setting:`USE_TZ` is ``True``, fields are converted to the current time
zone before filtering. zone before filtering. This requires :ref:`time zone definitions in the
database <database-time-zone-definitions>`.
.. fieldlookup:: hour .. fieldlookup:: hour
@ -3181,8 +3186,9 @@ SQL equivalent:
(The exact SQL syntax varies for each database engine.) (The exact SQL syntax varies for each database engine.)
For datetime fields, when :setting:`USE_TZ` is ``True``, values are converted When :setting:`USE_TZ` is ``True``, datetime fields are converted to the
to the current time zone before filtering. current time zone before filtering. This requires :ref:`time zone definitions
in the database <database-time-zone-definitions>`.
.. fieldlookup:: minute .. fieldlookup:: minute
@ -3208,8 +3214,9 @@ SQL equivalent:
(The exact SQL syntax varies for each database engine.) (The exact SQL syntax varies for each database engine.)
For datetime fields, When :setting:`USE_TZ` is ``True``, values are converted When :setting:`USE_TZ` is ``True``, datetime fields are converted to the
to the current time zone before filtering. current time zone before filtering. This requires :ref:`time zone definitions
in the database <database-time-zone-definitions>`.
.. fieldlookup:: second .. fieldlookup:: second
@ -3235,8 +3242,9 @@ SQL equivalent:
(The exact SQL syntax varies for each database engine.) (The exact SQL syntax varies for each database engine.)
For datetime fields, when :setting:`USE_TZ` is ``True``, values are converted When :setting:`USE_TZ` is ``True``, datetime fields are converted to the
to the current time zone before filtering. current time zone before filtering. This requires :ref:`time zone definitions
in the database <database-time-zone-definitions>`.
.. fieldlookup:: isnull .. fieldlookup:: isnull