Improved docs for timezone handling for auto_now and auto_now_add

Thanks djbug for the report and Aymeric Augustin and Carl Meyer for the
review.
This commit is contained in:
Christopher Luc 2015-03-21 17:45:42 -07:00 committed by Markus Holtermann
parent 75430be86f
commit 8119876d4a
2 changed files with 11 additions and 2 deletions

View file

@ -505,6 +505,15 @@ Any combination of these options will result in an error.
``True`` will cause the field to have ``editable=False`` and ``blank=True``
set.
.. note::
The ``auto_now`` and ``auto_now_add`` options will always use the date in
the :ref:`default timezone <default-current-time-zone>` at the moment of
creation or update. If you need something different, you may want to
consider simply using your own callable default or overriding ``save()``
instead of using ``auto_now`` or ``auto_now_add``; or using a
``DateTimeField`` instead of a ``DateField`` and deciding how to handle the
conversion from datetime to date at display time.
``DateTimeField``
-----------------