summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorCarlton Gibson <carlton.gibson@noumenal.es>2021-09-09 12:56:54 +0200
committerCarlton Gibson <carlton.gibson@noumenal.es>2021-09-09 12:56:54 +0200
commit84cb8fd4394c7080c9294974f1c4b0f733c0cdf0 (patch)
treebc6040351e34cb7e4ed826f259721be7c4d9724a /docs/ref
parentdad1f9d3fd950e0627d2eeef6e37a2fa34931ba2 (diff)
downloaddjango-make-zoneinfo-default-timezone-implementation.tar.gz
Release notes and deprecation.txt pending.
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/models/database-functions.txt16
-rw-r--r--docs/ref/models/querysets.txt5
2 files changed, 21 insertions, 0 deletions
diff --git a/docs/ref/models/database-functions.txt b/docs/ref/models/database-functions.txt
index 18dfdae976..a2637aec2a 100644
--- a/docs/ref/models/database-functions.txt
+++ b/docs/ref/models/database-functions.txt
@@ -524,6 +524,10 @@ The ``is_dst`` parameter indicates whether or not ``pytz`` should interpret
nonexistent and ambiguous datetimes in daylight saving time. By default (when
``is_dst=None``), ``pytz`` raises an exception for such datetimes.
+.. versionchanged:: 4.0
+
+ The ``is_dst`` parameter is deprecated and will be removed in Django 5.0.
+
Given the datetime ``2015-06-15 14:30:50.000321+00:00``, the built-in ``kind``\s
return:
@@ -607,6 +611,10 @@ Usage example::
.. attribute:: kind = 'quarter'
+.. versionchanged:: 4.0
+
+ The ``is_dst`` parameter is deprecated and will be removed in Django 5.0.
+
These are logically equivalent to ``Trunc('date_field', kind)``. They truncate
all parts of the date up to ``kind`` which allows grouping or filtering dates
with less precision. ``expression`` can have an ``output_field`` of either
@@ -691,6 +699,10 @@ truncate function. It's also registered as a transform on ``DateTimeField`` as
.. attribute:: kind = 'second'
+.. versionchanged:: 4.0
+
+ The ``is_dst`` parameter is deprecated and will be removed in Django 5.0.
+
These are logically equivalent to ``Trunc('datetime_field', kind)``. They
truncate all parts of the date up to ``kind`` and allow grouping or filtering
datetimes with less precision. ``expression`` must have an ``output_field`` of
@@ -740,6 +752,10 @@ Usage example::
.. attribute:: kind = 'second'
+.. versionchanged:: 4.0
+
+ The ``is_dst`` parameter is deprecated and will be removed in Django 5.0.
+
These are logically equivalent to ``Trunc('time_field', kind)``. They truncate
all parts of the time up to ``kind`` which allows grouping or filtering times
with less precision. ``expression`` can have an ``output_field`` of either
diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt
index 333c0054c6..44d876227a 100644
--- a/docs/ref/models/querysets.txt
+++ b/docs/ref/models/querysets.txt
@@ -834,6 +834,11 @@ object. If it's ``None``, Django uses the :ref:`current time zone
ambiguous datetimes in daylight saving time. By default (when ``is_dst=None``),
``pytz`` raises an exception for such datetimes.
+.. versionchanged:: 4.0
+
+ The ``is_dst`` parameter is deprecated and will be removed in Django
+ 5.0.
+
.. _database-time-zone-definitions:
.. note::