Fixed #31608 -- Doc'd that form ISO 8601 datetime parsing always retains tzinfo.

This commit is contained in:
Hasan Ramezani 2020-05-21 20:45:39 +02:00 committed by GitHub
parent c60524c658
commit 643207efae
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 12 additions and 5 deletions

View File

@ -2782,7 +2782,10 @@ Default: ``False``
A boolean that specifies if datetimes will be timezone-aware by default or not. A boolean that specifies if datetimes will be timezone-aware by default or not.
If this is set to ``True``, Django will use timezone-aware datetimes internally. If this is set to ``True``, Django will use timezone-aware datetimes internally.
Otherwise, Django will use naive datetimes in local time.
When ``USE_TZ`` is False, Django will use naive datetimes in local time, except
when parsing ISO 8601 formatted strings, where timezone information will always
be retained if present.
See also :setting:`TIME_ZONE`, :setting:`USE_I18N` and :setting:`USE_L10N`. See also :setting:`TIME_ZONE`, :setting:`USE_I18N` and :setting:`USE_L10N`.

View File

@ -274,10 +274,14 @@ Forms
details. details.
* :class:`django.forms.DateTimeField` now accepts dates in a subset of ISO 8601 * :class:`django.forms.DateTimeField` now accepts dates in a subset of ISO 8601
datetime formats, including optional timezone (e.g. ``2019-10-10T06:47``, datetime formats, including optional timezone, e.g. ``2019-10-10T06:47``,
``2019-10-10T06:47:23+04:00``, or ``2019-10-10T06:47:23Z``). Additionally, it ``2019-10-10T06:47:23+04:00``, or ``2019-10-10T06:47:23Z``. The timezone will
now uses ``DATE_INPUT_FORMATS`` in addition to ``DATETIME_INPUT_FORMATS`` always be retained if provided, with timezone-aware datetimes being returned
when converting a field input to a ``datetime`` value. even when :setting:`USE_TZ` is ``False``.
Additionally, ``DateTimeField`` now uses ``DATE_INPUT_FORMATS`` in addition
to ``DATETIME_INPUT_FORMATS`` when converting a field input to a ``datetime``
value.
* :attr:`.MultiWidget.widgets` now accepts a dictionary which allows * :attr:`.MultiWidget.widgets` now accepts a dictionary which allows
customizing subwidget ``name`` attributes. customizing subwidget ``name`` attributes.