Локализация формата¶

Быстрый обзор¶

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

Когда эта функция включена, два пользователя, получающие доступ к одному и тому же содержимому, могут видеть даты, время и числа, отформатированные по-разному, в зависимости от форматов их текущей локали.

По умолчанию система форматирования включена. Для ее отключения необходимо установить USE_L10N = False в файле настроек.

Ввод в формах с учетом локали¶

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

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

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

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

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

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

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

{% load l10n %}

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

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

{% load l10n %}

{{ value|localize }}

{% load l10n %}

{{ value|unlocalize }}

Создание файлов пользовательского формата¶

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

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

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

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

Для настройки английских форматов потребуется такая структура:

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

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

THOUSAND_SEPARATOR = "\xa0"

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

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

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