Django の表示形式システムは、カレント ロケール に合った表示形式を使って日付、時刻、数値をテンプレート内で表示することができます。また、フォームでのローカル化された入力も処理します。
\nこの機能が有効のとき、同じコンテンツにアクセスする 2 人のユーザは、違う形で日付、時刻、数値を目にすることになるでしょう。これは、現在のロケールの表示形式に依存します。
\nデフォルトでは、表示形式システムは無効になっています。有効化するには、設定ファイル内の USE_L10N = True をセットする必要があります。
表示形式機能が有効のとき、Django がフォーム内で日付、時刻、数値を描画する際に、ローカル化された表示形式を使用することができます。フォームにデータが入力されたとき、ユーザによって使用される表示形式を推測し、異なるロケールに対する異なる表示形式を試みることを意味します。
\n\nフォームフィールドにローカル化された入力を有効化してデータを出力するには、単に localize 引数を使ってください:
class CashRegisterForm(forms.Form):\n product = forms.CharField()\n revenue = forms.DecimalField(max_digits=4, decimal_places=2, localize=True)\nUSE_L10N で表示形式を有効にしたとき、Django はテンプレート内で値が出力されたときはいつでもロケールに対応した表示形式を使います。
しかし、ローカル化された値を使うことが適切ではないこともあります -- 例えば、機械可読的に絵座員された JavaScript や XML を出力している場合、常にローカル化されていない値が必要でしょう。また、全ての場所でローカル化を適用するのではなく、特定のテンプレートだけで使いたいときもあるかもしれません。
\nローカル化の仕様について細かいコントロールをするために、Django は l10n テンプレートライブラリを提供しています。これは、以下のタグやフィルタを含んでいます。
localizeLink to this heading#単数のローカル化を強制します。
\n例:
\n{% load l10n %}\n\n{{ value|localize }}\n単数のローカル化を無効化するには、unlocalize を使ってください。テンプレートの大きな範囲を通じてローカル化をコントロールするには、localize テンプレートタグを使ってください。
unlocalizeLink to this heading#単数形がローカル化されずに表示されるように強制します。
\n例:
\n{% load l10n %}\n\n{{ value|unlocalize }}\n単数のローカル化を強制するには、localize を使ってください。テンプレートの大きな範囲を通じてローカル化をコントロールするには、localize テンプレートタグを使ってください。
Django は多くのロケールに対して表示形式の定義を準備していますが、あなたのロケールに対して表示形式ファイルが存在しなかったり、値のいくつかを上書きしたいときには、独自の定義を作成したいこともあるでしょう。
\n独自の表示形式を使うには、最初に表示形式を設置するパスを指定してください。そのために、FORMAT_MODULE_PATH 設定を表示形式ファイルを置く予定のパッケージにセットしてください。例えば:
FORMAT_MODULE_PATH = [\n 'mysite.formats',\n 'some_app.formats',\n]\nFiles are not placed directly in this directory, but in a directory named as\nthe locale, and must be named formats.py. Be careful not to put sensitive\ninformation in these files as values inside can be exposed if you pass the\nstring to django.utils.formats.get_format() (used by the date\ntemplate filter).
To customize the English formats, a structure like this would be needed:
\nmysite/\n formats/\n __init__.py\n en/\n __init__.py\n formats.py\nwhere formats.py contains custom format definitions. For example:
THOUSAND_SEPARATOR = '\\xa0'\nto use a non-breaking space (Unicode 00A0) as a thousand separator,\ninstead of the default for English, a comma.
いくつかのロケールは、数字に対して文脈依存の表示形式を使います。これは、Django のローカル化システムでは自動的に扱うことはできません。
\nスイスの数値の表示形式は、対象となる数字の種類によって決まります。貨幣の値に対しては、カンマが 1000 区切りに使われ、小数点が小数区切りに使われます。他の数字に対しては、カンマは小数区切りとして使われ、空白が 1000 区切りとして使われます。Django によって提供されるロケール表示形式は、一般的な区切り文字、つまり小数にはカンマそして1000 区切りには空白を使用します。
\n