|
@@ -929,9 +929,21 @@ For a complete discussion on the usage of the following see the
|
|
|
|
|
|
.. function:: now()
|
|
|
|
|
|
- Returns an aware or naive :class:`~datetime.datetime` that represents the
|
|
|
- current point in time when :setting:`USE_TZ` is ``True`` or ``False``
|
|
|
- respectively.
|
|
|
+ Returns a :class:`~datetime.datetime` that represents the
|
|
|
+ current point in time. Exactly what's returned depends on the value of
|
|
|
+ :setting:`USE_TZ`:
|
|
|
+
|
|
|
+ * If :setting:`USE_TZ` is ``False``, this will be be a
|
|
|
+ :ref:`naive <naive_vs_aware_datetimes>` datetime (i.e. a datetime
|
|
|
+ without an associated timezone) that represents the current time
|
|
|
+ in the system's local timezone.
|
|
|
+
|
|
|
+ * If :setting:`USE_TZ` is ``True``, this will be an
|
|
|
+ :ref:`aware <naive_vs_aware_datetimes>` datetime representing the
|
|
|
+ current time in UTC. Note that :func:`now` will always return
|
|
|
+ times in UTC regardless of the value of :setting:`TIME_ZONE`;
|
|
|
+ you can use :func:`localtime` to convert to a time in the current
|
|
|
+ time zone.
|
|
|
|
|
|
.. function:: is_aware(value)
|
|
|
|