Обзор¶

Система форматирования Django имеет возможность отображать в шаблонах даты, время и числа, используя формат, определённый для текущей локали. Она также поддерживает локализованный ввод в формы.

When it’s enabled, two users accessing the same content may see dates, times and numbers formatted in different ways, depending on the formats for their current locale.

The formatting system is disabled by default. To enable it, it’s necessary to set USE_L10N = True in your settings file.

Локализованный ввод в формах¶

При активированной системе форматирования Django может использовать локализованные форматы при обработке дат, времён и чисел в формах. Это означает, что она применяет различные форматы для разных локалей, при определении формата, использованного пользователем при вводе данных в формы.

Для того, чтобы разрешить полю использовать локализацию для вводимых и выводимых данных, используйте его аргумент localize:

class CashRegisterForm(forms.Form):
   product = forms.CharField()
   revenue = forms.DecimalField(max_digits=4, decimal_places=2, localize=True)

Управление локализацией в шаблонах¶

When you have enabled formatting with USE_L10N, Django will try to use a locale specific format whenever it outputs a value in a template.

Тем не менее, использование локализованных значений подходит не во всех случаях. Например, при выводе JavaScript или XML, которые не предназначены для чтения людьми, вам всегда будут нужны не локализированные значения. Также может потребоваться использовать локализацию только в нужных шаблонах, а не во всех.

Для решения задачи по контролю над использованием локализации, Django предоставляет шаблонную библиотеку l10n, которая содержит следующие теги и фильтры.

{% load l10n %}

{% localize on %}
    {{ value }}
{% endlocalize %}

{% localize off %}
    {{ value }}
{% endlocalize %}

{% load l10n %}

{{ value|localize }}

{% load l10n %}

{{ value|unlocalize }}

Создание собственных форматов¶

Django provides format definitions for many locales, but sometimes you might want to create your own, because a format files doesn’t exist for your locale, or because you want to overwrite some of the values.

Для использования собственных форматов требуется указать путь до пакета, в котором они определены. Для этого предназначен параметр конфигурации FORMAT_MODULE_PATH, например:

FORMAT_MODULE_PATH = [
    'mysite.formats',
    'some_app.formats',
]

Файлы помещаются не в каталог, а в подкаталог с названием locale, и должны называться formats.py. Осторожно, не помещайте важные данные в эти файлы т.к. значения могут быть отображены пользователю при передаче в django.utils.formats.get_format() (например шаблонным фильтром date).

To customize the English formats, a structure like this would be needed:

mysite/
    formats/
        __init__.py
        en/
            __init__.py
            formats.py

где formats.py содержит определения своих форматов. Например:

THOUSAND_SEPARATOR = '\xa0'

для использования неразрывного пробела (Unicode 00A0) в качестве разделителя разрядов, вместо стандартной для англичан точки.

Ограничения предоставленных форматов локализации¶

Некоторые локали используют контекстно-зависимое форматирование для чисел, которое не в состоянии автоматически обработать система локализации Django.