本地格式化Link to this heading#

概况Link to this heading#

Django 的格式化系统可以在模板中使用指定的格式化工具为当前的 locale 来显示日期、时间和数字。

两个用户访问相同的内容可能会根据其当前区域设置的格式，以不同的方式看到日期、时间和数字的格式化方式。

表单中感知本地语言环境输入Link to this heading#

格式化开启后，当在表单里解析日期、时间和数字时，Django 可以使用本地化格式。这意味着猜测用户在表单上的输入时所使用的格式化时，会对不同语言环境尝试不同的格式化。

使用 localize 参数来使表单字段能本地化输入和输出数据：

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

在模板中控制本地化Link to this heading#

Django 在模板中输出值时会尽量使用与区域设置相关的格式。

然而，使用本地化值可能并不总是合适的——比如，如果你正在输出机器可读的 JavaScript 或 XML ，则始终需要非本地化的值。你也可以在已选的模板里使用本地化，而不是在所有地方使用。

为了更好的控制本地化的使用，Django 提供 l10n 模板库，它包含以下的 tags 和 filters。

{% load l10n %}

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

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

{% load l10n %}

{{ value|localize }}

{% load l10n %}

{{ value|unlocalize }}

创建自定义的格式化文件Link to this heading#

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 ）作为千位分隔符，而不是英语的默认逗号。

提供本地语言环境格式化的局限性Link to this heading#

一些本地语言环境为数字使用上下文相关的格式化，而 Django 本地化系统不能自动处理。