diff options
| author | Jon Dufresne <jon.dufresne@gmail.com> | 2014-10-15 19:52:41 -0700 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2014-10-20 12:42:10 -0400 |
| commit | 59026bfbf957cd31c659bdfac36d992816eba114 (patch) | |
| tree | 47e65911ab86398826a2492fb7f4ce50de5f43dd /docs | |
| parent | 740934b507856d38c026d5f47dba32588688204b (diff) | |
Fixed #23668 -- Changed make_aware() and make_naive() to use the current timezone by default
Thanks Aymeric Augustin for review.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ref/utils.txt | 18 |
1 files changed, 14 insertions, 4 deletions
diff --git a/docs/ref/utils.txt b/docs/ref/utils.txt index 6a33f8bb93..507f3d6095 100644 --- a/docs/ref/utils.txt +++ b/docs/ref/utils.txt @@ -954,20 +954,30 @@ 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) +.. 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`. + :class:`~datetime.datetime`. If ``timezone`` is set to ``None``, it + defaults to the :ref:`current time zone <default-current-time-zone>`. This function can raise an exception if ``value`` doesn't exist or is ambiguous because of DST transitions. -.. function:: make_naive(value, timezone) + .. versionchanged:: 1.8 + + In older versions of Django, ``timezone`` was a required argument. + +.. function:: make_naive(value, timezone=None) Returns an naive :class:`~datetime.datetime` that represents in ``timezone`` the same point in time as ``value``, ``value`` being an - aware :class:`~datetime.datetime` + aware :class:`~datetime.datetime`. If ``timezone`` is set to ``None``, it + defaults to the :ref:`current time zone <default-current-time-zone>`. + + .. versionchanged:: 1.8 + + In older versions of Django, ``timezone`` was a required argument. .. _pytz: http://pytz.sourceforge.net/ |
