summaryrefslogtreecommitdiff
path: root/docs/ref/utils.txt
diff options
context:
space:
mode:
authorMariusz Felisiak <felisiak.mariusz@gmail.com>2023-01-09 09:52:26 +0100
committerMariusz Felisiak <felisiak.mariusz@gmail.com>2023-01-17 11:49:15 +0100
commit2fad1632571af551d6065d7eced93ffe93a8a945 (patch)
treeb926abed87ff568f36f42c18758a6cb56711f2a0 /docs/ref/utils.txt
parente6f82438d4e3750e8d299bfd79dac98eebe9f1e0 (diff)
Refs #32365 -- Removed is_dst argument for various methods and functions.
Per deprecation timeline.
Diffstat (limited to 'docs/ref/utils.txt')
-rw-r--r--docs/ref/utils.txt27
1 files changed, 1 insertions, 26 deletions
diff --git a/docs/ref/utils.txt b/docs/ref/utils.txt
index de7f0d1259..2a8a8357fb 100644
--- a/docs/ref/utils.txt
+++ b/docs/ref/utils.txt
@@ -972,38 +972,13 @@ appropriate entities.
Returns ``True`` if ``value`` is naive, ``False`` if it is aware. This
function assumes that ``value`` is a :class:`~datetime.datetime`.
-.. function:: make_aware(value, timezone=None, is_dst=None)
+.. function:: make_aware(value, timezone=None)
Returns an aware :class:`~datetime.datetime` that represents the same
point in time as ``value`` in ``timezone``, ``value`` being a naive
:class:`~datetime.datetime`. If ``timezone`` is set to ``None``, it
defaults to the :ref:`current time zone <default-current-time-zone>`.
- .. deprecated:: 4.0
-
- When using ``pytz``, the ``pytz.AmbiguousTimeError`` exception is
- raised if you try to make ``value`` aware during a DST transition where
- the same time occurs twice (when reverting from DST). Setting
- ``is_dst`` to ``True`` or ``False`` will avoid the exception by
- choosing if the time is pre-transition or post-transition respectively.
-
- When using ``pytz``, the ``pytz.NonExistentTimeError`` exception is
- raised if you try to make ``value`` aware during a DST transition such
- that the time never occurred. For example, if the 2:00 hour is skipped
- during a DST transition, trying to make 2:30 aware in that time zone
- will raise an exception. To avoid that you can use ``is_dst`` to
- specify how ``make_aware()`` should interpret such a nonexistent time.
- If ``is_dst=True`` then the above time would be interpreted as 2:30 DST
- time (equivalent to 1:30 local time). Conversely, if ``is_dst=False``
- the time would be interpreted as 2:30 standard time (equivalent to 3:30
- local time).
-
- The ``is_dst`` parameter has no effect when using non-``pytz`` timezone
- implementations.
-
- The ``is_dst`` parameter is deprecated and will be removed in Django
- 5.0.
-
.. function:: make_naive(value, timezone=None)
Returns a naive :class:`~datetime.datetime` that represents in