Django的格式化系統(tǒng)可以在模板中使用當前地區(qū)特定的格式,來展示日期、時間和數(shù)字。也可以處理表單中輸入的本地化。
當它被開啟時,訪問相同內(nèi)容的兩個用戶可能會看到以不同方式格式化的日期、時間和數(shù)字,這取決于它們的當前地區(qū)的格式。
格式化系統(tǒng)默認是禁用的。需要在你的設(shè)置文件中設(shè)置USE_L10N = True來啟用它。
注意
為了方便起見,django-admin startproject創(chuàng)建的默認的settings.py文件包含了 [USE_L10N = True](../../ref/settings.html#std:setting-USE_L10N) 的設(shè)置。但是要注意,要開啟千位分隔符的數(shù)字格式化,你需要在你的設(shè)置文件中設(shè)置USE_THOUSAND_SEPARATOR = True?;蛘撸阋部梢栽谀愕哪0逯惺褂?a href="../../ref/contrib/humanize.html#std:templatefilter-intcomma">intcomma來格式化數(shù)字。
注意
USE_I18N 是另一個獨立的并且相關(guān)的設(shè)置,它控制著Django是否應(yīng)該開啟翻譯。詳見翻譯。
格式化開啟之后,Django可以在表單中使用本地化格式來解析日期、時間和數(shù)字。也就是說,在表單上輸入時,它會嘗試不同的格式和地區(qū)來猜測用戶使用的格式。
注意
Django對于展示數(shù)據(jù),使用和解析數(shù)據(jù)不同的格式。尤其是,解析日期的格式不能使用%a(星期名稱的縮寫),%A (星期名稱的全稱),%b (月份名稱的縮寫), %B(月份名稱的全稱),或者%p(上午/下午)。
只是使用localize參數(shù),就能開啟表單字段的本地化輸入和輸出:
class CashRegisterForm(forms.Form):
product = forms.CharField()
revenue = forms.DecimalField(max_digits=4, decimal_places=2, localize=True)
當你使用USE_L10N來開啟格式化的時候,Django會嘗試使用地區(qū)特定的格式,無論值在模板的什么位置輸出。
然而,這對于本地化的值不可能總是十分合適,如果你在輸出JavaScript或者機器閱讀的XML,你會想要使用去本地化的值。你也可能想只在特定的模板中使用本地化,而不是任何位置都使用。
DJango提供了l10n模板庫,包含以下標簽和過濾器,來實現(xiàn)對本地化的精細控制。
在包含的代碼塊內(nèi)開啟或關(guān)閉模板變量的本地化。
這個標簽可以對本地化進行比USE_L10N更加精細的操作。
這樣做來為一個模板激活或禁用本地化:
{% load l10n %}
{% localize on %}
{{ value }}
{% endlocalize %}
{% localize off %}
{{ value }}
{% endlocalize %}
注意
在 {% localize %}代碼塊內(nèi)并不遵循f USE_L10N的值。
對于在每個變量基礎(chǔ)上執(zhí)行相同工作的模板過濾器,參見localize 和 unlocalize。
強制單一值的本地化。
例如:
{% load l10n %}
{{ value|localize }}
使用unlocalize來在單一值上禁用本地化。使用localize 模板標簽來在大塊的模板區(qū)域內(nèi)控制本地化。
強制單一值不帶本地化輸出。
例如:
{% load l10n %}
{{ value|unlocalize }}
使用localize來強制單一值的本地化。使用localize模板標簽來在大塊的模板區(qū)域內(nèi)控制本地化。
Django為許多地區(qū)提供了格式定義,但是有時你可能想要創(chuàng)建你自己的格式,因為你的的確并沒有現(xiàn)成的格式文件,或者你想要覆寫其中的一些值。
Changed in Django 1.8:
添加了指定FORMAT_MODULE_PATH為列表的功能。之前只支持單一的字符串值。
指定你首先放置格式文件的位置來使用自定義格式。把你的FORMAT_MODULE_PATH設(shè)置設(shè)置為格式文件存在的包名來使用它,例如:
FORMAT_MODULE_PATH = [
'mysite.formats',
'some_app.formats',
]
文件并不直接放在這個目錄中,而是放在和地區(qū)名稱相同的目錄中,文件也必須名為formats.py。
需要這樣一個結(jié)構(gòu)來自定義英文格式:
mysite/
formats/
__init__.py
en/
__init__.py
formats.py
其中formats.py包含自定義的格式定義。例如:
from __future__ import unicode_literals
THOUSAND_SEPARATOR = '\xa0'
使用非間斷空格(Unicode 00A0)作為千位分隔符,來代替英語中默認的逗號。
一些地區(qū)對數(shù)字使用上下文敏感的格式,Django的本地化系統(tǒng)不能自動處理它。
瑞士的數(shù)字格式化取決于被格式化的數(shù)字類型。對于貨幣值,使用逗號作為千位分隔符,以及使用小數(shù)點作為十進制分隔符。對于其它數(shù)字,逗號用于十進制分隔符,空格用于千位分隔符。Django提供的本地格式使用通用的分隔符,即逗號用于十進制分隔符,空格用于千位分隔符。
譯者:Django 文檔協(xié)作翻譯小組,原文:ocalized Web UI formatting and form input。
本文以 CC BY-NC-SA 3.0 協(xié)議發(fā)布,轉(zhuǎn)載請保留作者署名和文章出處。
Django 文檔協(xié)作翻譯小組人手緊缺,有興趣的朋友可以加入我們,完全公益性質(zhì)。交流群:467338606。