mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-03-14 03:10:45 +00:00
Code Issues 32 Releases Wiki Activity

[5.1.x] Fixed #24076 -- Added warnings on usage of dates with DateTimeField and datetimes with DateField.

Browse Source 
Backport of 99273fd525129a973639044dfb12cfd732d8f1d6 from main.
This commit is contained in:
Adam Zapletal 2024-03-19 21:19:31 -05:00 committed by Sarah Boyce
parent ae032fed89
commit bf9a89f5d1
1 changed files with 19 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
docs/ref/models/fields.txt
View File

@ -808,6 +808,15 @@ Any combination of these options will result in an error.
instead of a ``DateField`` and deciding how to handle the conversion from
datetime to date at display time.
.. warning:: Always use :class:`DateField` with a ``datetime.date`` instance.
If you have a ``datetime.datetime`` instance, it's recommended to convert
it to a ``datetime.date`` first. If you don't, :class:`DateField` will
localize the ``datetime.datetime`` to the :ref:`default timezone
<default-current-time-zone>` and convert it to a ``datetime.date``
instance, removing its time component. This is true for both storage and
comparison.
``DateTimeField``
-----------------
@ -820,6 +829,16 @@ The default form widget for this field is a single
:class:`~django.forms.DateTimeInput`. The admin uses two separate
:class:`~django.forms.TextInput` widgets with JavaScript shortcuts.
.. warning:: Always use :class:`DateTimeField` with a ``datetime.datetime``
instance.
If you have a ``datetime.date`` instance, it's recommended to convert it to
a ``datetime.datetime`` first. If you don't, :class:`DateTimeField` will
use midnight in the :ref:`default timezone <default-current-time-zone>` for
the time component. This is true for both storage and comparison. To
compare the date portion of a :class:`DateTimeField` with a
``datetime.date`` instance, use the :lookup:`date` lookup.
``DecimalField``
----------------