diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt index c65ddc55429..166a84f2fc7 100644 --- a/docs/ref/templates/builtins.txt +++ b/docs/ref/templates/builtins.txt @@ -1458,12 +1458,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.:: @@ -2168,12 +2174,19 @@ attached timezone information (a :ref:`time-zone-aware accept the timezone-related :ref:`format 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 diff --git a/docs/releases/1.10.txt b/docs/releases/1.10.txt index a84912941a4..f071c587d1a 100644 --- a/docs/releases/1.10.txt +++ b/docs/releases/1.10.txt @@ -919,6 +919,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