summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorTim Graham <timograham@gmail.com>2014-07-31 12:54:11 -0400
committerTim Graham <timograham@gmail.com>2014-07-31 12:54:11 -0400
commitda599022504995891bf745a6424e242ca9097b07 (patch)
tree5556cd9ecbd461ee298e26ce047f963532fca59f /docs
parent0dd05c9e66ebb5cb97136f84373f43582783e1a6 (diff)
Updated timezone docs to use timezone.now()
Thanks James Cleveland for the report and Aymeric for suggesting the solution.
Diffstat (limited to 'docs')
-rw-r--r--docs/topics/i18n/timezones.txt19
1 files changed, 6 insertions, 13 deletions
diff --git a/docs/topics/i18n/timezones.txt b/docs/topics/i18n/timezones.txt
index d41ede8898..d42ca09707 100644
--- a/docs/topics/i18n/timezones.txt
+++ b/docs/topics/i18n/timezones.txt
@@ -78,20 +78,13 @@ the current time, you would write::
now = datetime.datetime.now()
-When time zone support is enabled, Django uses time-zone-aware datetime
-objects. If your code creates datetime objects, they should be aware too. In
-this mode, the example above becomes::
+When time zone support is enabled (:setting:`USE_TZ=True <USE_TZ>`), Django uses
+time-zone-aware datetime objects. If your code creates datetime objects, they
+should be aware too. In this mode, the example above becomes::
- import datetime
- from django.utils.timezone import utc
-
- now = datetime.datetime.utcnow().replace(tzinfo=utc)
-
-.. note::
+ from django.utils import timezone
- :mod:`django.utils.timezone` provides a
- :func:`~django.utils.timezone.now()` function that returns a naive or
- aware datetime object according to the value of :setting:`USE_TZ`.
+ now = timezone.now()
.. warning::
@@ -554,7 +547,7 @@ Troubleshooting
>>> import datetime
>>> from django.utils import timezone
>>> naive = datetime.datetime.utcnow()
- >>> aware = naive.replace(tzinfo=timezone.utc)
+ >>> aware = timezone.now()
>>> naive == aware
Traceback (most recent call last):
...