innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

[1.10.x] Fixed #27981 -- Doc'd date/time filter l10n changes in refs #25758. 

Backport of 6585ebebaa from master
This commit is contained in:
Claude Paroz 2017-03-27 18:53:03 +02:00 committed by Tim Graham
parent 72d4b39c7a
commit 16b97a2ceb
2 changed files with 24 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
docs/ref/templates/builtins.txt
View File

@ -1396,12 +1396,18 @@ for example, ``"es"``, then for::
the output would be the string ``"09/01/2008"`` (the ``"SHORT_DATE_FORMAT"``
format specifier for the ``es`` locale as shipped with Django is ``"d/m/Y"``).
When used without a format string::
When used without a format string, the ``DATE_FORMAT`` format specifier is
used. Assuming the same settings as the previous example::
{{ value|date }}
...the formatting string defined in the :setting:`DATE_FORMAT` setting will be
used, without applying any localization.
outputs ``9 de Enero de 2008`` (the ``DATE_FORMAT`` format specifier for the
``es`` locale is ``r'j \d\e F \d\e Y'``.
.. versionchanged:: 1.10
In older versions, the :setting:`DATE_FORMAT` setting (without
localization) is always used when a format string isn't given.
You can combine ``date`` with the :tfilter:`time` filter to render a full
representation of a ``datetime`` value. E.g.::
@ -2122,12 +2128,19 @@ attached timezone information (a :ref:`time-zone-aware
accept the timezone-related :ref:`format specifiers
<date-and-time-formatting-specifiers>` ``'e'``, ``'O'`` , ``'T'`` and ``'Z'``.
When used without a format string::
When used without a format string, the ``TIME_FORMAT`` format specifier is
used::
{{ value|time }}
...the formatting string defined in the :setting:`TIME_FORMAT` setting will be
used, without applying any localization.
is the same as::
{{ value|time:"TIME_FORMAT" }}
.. versionchanged:: 1.10
In older versions, the :setting:`TIME_FORMAT` setting (without
localization) is always used when a format string isn't given.
.. templatefilter:: timesince

5
docs/releases/1.10.txt
View File

@ -918,6 +918,11 @@ Miscellaneous
To adapt, move the fragment outside the template tag:
``{% static 'img.svg' %}#fragment``.
* When :setting:`USE_L10N` is ``True``, localization is now applied for the
:tfilter:`date` and :tfilter:`time` filters when no format string is
specified. The ``DATE_FORMAT`` and ``TIME_FORMAT`` specifiers from the active
locale are used instead of the settings of the same name.
.. _deprecated-features-1.10:
Features deprecated in 1.10