mirror of
https://github.com/django/django.git
synced 2025-03-15 20:00:46 +00:00
Fixed #24076 -- Added warnings on usage of dates with DateTimeField and datetimes with DateField.
This commit is contained in:
parent
7e39ae5c8c
commit
99273fd525
@ -798,6 +798,15 @@ Any combination of these options will result in an error.
|
|||||||
instead of a ``DateField`` and deciding how to handle the conversion from
|
instead of a ``DateField`` and deciding how to handle the conversion from
|
||||||
datetime to date at display time.
|
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``
|
``DateTimeField``
|
||||||
-----------------
|
-----------------
|
||||||
|
|
||||||
@ -810,6 +819,16 @@ The default form widget for this field is a single
|
|||||||
:class:`~django.forms.DateTimeInput`. The admin uses two separate
|
:class:`~django.forms.DateTimeInput`. The admin uses two separate
|
||||||
:class:`~django.forms.TextInput` widgets with JavaScript shortcuts.
|
: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``
|
``DecimalField``
|
||||||
----------------
|
----------------
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user