表示形式のローカライズ¶
概要¶
Django の表示形式システムは、カレント ロケール に合った表示形式を使って日付、時刻、数値をテンプレート内で表示することができます。また、フォームでのローカライズされた入力も処理します。
同じコンテンツにアクセスする2人のユーザーが、現在のロケールのフォーマットに応じて、日付、時刻、数字を異なる方法で表示することがあります。
注釈
3桁区切りを使用した数値フォーマットを有効にするには、設定ファイルで USE_THOUSAND_SEPARATOR = True
を設定する必要があります。別の方法として、 intcomma
を使ってテンプレート内で数値をフォーマットすることもできます。
フォームでのロケールを認識する入力¶
表示形式機能が有効のとき、Django がフォーム内で日付、時刻、数値を描画する際に、ローカライズされた表示形式を使用できます。フォームにデータが入力されたとき、ユーザによって使用される表示形式を推測し、異なるロケールに対する異なる表示形式を試みることを意味します。
注釈
Django は、データを描画するために使うものに対して、データを表示するための異なる表示形式を使います。特に、日付を描画するための表示形式は、%a
(省略された曜日名)、%A
(曜日名), %b
(省略された月名)、%B
(月名)、%p
(AM/PM) を使うことができません。
フォームフィールドの入出力データをローカライズするには localize
引数を使います:
class CashRegisterForm(forms.Form):
product = forms.CharField()
revenue = forms.DecimalField(max_digits=4, decimal_places=2, localize=True)
テンプレート内でローカライズをコントロールする¶
Django はテンプレートで値を出力するときは常にロケール固有の書式を使おうとし ます。
しかし、ローカライズされた値を使うことが適切ではないこともあります -- 例えば、機械が読み込むためにデザインされた JavaScript や XML を出力している場合、どんなときでも非ローカルの値が必要でしょう。また、全ての場所でローカライズを適用するのではなく、特定のテンプレートだけで使いたいときもあるかもしれません。
ローカライズの仕様について細かいコントロールをするために、Django は l10n
テンプレートライブラリを提供しています。これは、以下のタグやフィルタを含んでいます。
テンプレートタグ¶
localize
¶
ブロック内で、テンプレート変数のローカライズを有効化または無効化します。
テンプレートブロックのローカライズを有効または無効にするには、次のようにします:
{% load l10n %}
{% localize on %}
{{ value }}
{% endlocalize %}
{% localize off %}
{{ value }}
{% endlocalize %}
When localization is disabled, the localization settings formats are applied.
各変数ベースで同じ仕事をするテンプレートフィルタについて、localize
と unlocalize
を参照してください。
テンプレートフィルタ¶
localize
¶
単数のローカライズを強制します。
例えば次のようにします:
{% load l10n %}
{{ value|localize }}
単数のローカライズを無効化するには、unlocalize
を使ってください。テンプレートの大きな範囲を通じてローカライズをコントロールするには、localize
テンプレートタグを使ってください。
unlocalize
¶
単数形がローカライズされずに表示されるように強制します。
例えば次のようにします:
{% load l10n %}
{{ value|unlocalize }}
単数のローカライズを強制するには、localize
を使ってください。テンプレートの大きな範囲を通じてローカライズをコントロールするには、localize
テンプレートタグを使ってください。
Returns a string representation for numbers (int
, float
, or
Decimal
) with the localization settings formats
applied.
独自の表示形式ファイルを作成する¶
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
)を3桁区切りとして使うことができます。