Django の表示形式システムは、カレント ロケール に合った表示形式を使って日付、時刻、数値をテンプレート内で表示することができます。また、フォームでのローカル化された入力も処理します。
\nこの機能が有効のとき、同じコンテンツにアクセスする 2 人のユーザは、違う形で日付、時刻、数値を目にすることになるでしょう。これは、現在のロケールの表示形式に依存します。
\nThe formatting system is enabled by default. To disable it, it's\nnecessary to set USE_L10N = False in your settings file.
表示形式機能が有効のとき、Django がフォーム内で日付、時刻、数値を描画する際に、ローカル化された表示形式を使用することができます。フォームにデータが入力されたとき、ユーザによって使用される表示形式を推測し、異なるロケールに対する異なる表示形式を試みることを意味します。
\n\nTo enable a form field to localize input and output data use its localize\nargument:
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 テンプレートタグを使ってください。
Returns a string representation for unlocalized numbers (int, float,\nor Decimal).
Django provides format definitions for many locales, but sometimes you might\nwant to create your own, because a format file doesn't exist for your locale,\nor because you want to overwrite some of the values.
\nTo use custom formats, specify the path where you'll place format files\nfirst. To do that, set your FORMAT_MODULE_PATH setting to the\npackage where format files will exist, for instance:
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