Django settings.THOUSAND_SEPARATOR で千の位区切り文字を設定

Django settings.THOUSAND_SEPARATOR 解説

settings.THOUSAND_SEPARATOR は、Django テンプレートで数字を表示する際に、千の位を区切るための文字を設定します。デフォルトでは空欄ですが、設定することで、カンマやスペースなどの区切り文字を挿入できます。

設定方法

settings.py ファイルに以下のコードを追加します。

# settings.py
USE_L10N = True
USE_THOUSAND_SEPARATOR = True

# 千の位区切り文字
THOUSAND_SEPARATOR = ','

USE_L10N と USE_THOUSAND_SEPARATOR

• USE_L10N: ロケール設定に基づいて、テンプレートで日付、時刻、数字をフォーマットするかどうかを制御します。True に設定すると、ロケール設定に基づいて千の位区切り文字が適用されます。
• USE_THOUSAND_SEPARATOR: 千の位区切り文字を有効にするかどうかを制御します。True に設定すると、THOUSAND_SEPARATOR で設定された文字が千の位ごとに挿入されます。

THOUSAND_SEPARATOR の値

• 空欄: 千の位区切り文字は挿入されません。
• 文字列: 指定された文字が千の位ごとに挿入されます。

例

# settings.py
USE_L10N = True
USE_THOUSAND_SEPARATOR = True

# 千の位区切り文字をカンマに設定
THOUSAND_SEPARATOR = ','

この設定の場合、テンプレートで {{ number }} と出力すると、number が 1000 を超える場合、カンマで区切られた数字が表示されます。

テンプレートでの使用

• {{ number }}: 数字をそのまま表示します。
• {{ number|intcomma }}: 千の位をカンマで区切ります。
• {{ number|localize }}: ロケール設定に基づいて数字をフォーマットします。

補足

• THOUSAND_SEPARATOR は、ロケール設定によって自動的に設定される場合があります。
• テンプレートで {% load i18n %} タグを使用すると、intcomma や localize フィルターなどの国際化機能を利用できます。

Django settings.THOUSAND_SEPARATOR サンプルコード

# settings.py
USE_L10N = True
USE_THOUSAND_SEPARATOR = True

# 千の位区切り文字をカンマに設定
THOUSAND_SEPARATOR = ','

テンプレート

{% load i18n %}

<h1>数字の表示</h1>

<p>{{ 123456789 }}</p>
<p>{{ 123456789|intcomma }}</p>
<p>{{ 123456789|localize }}</p>

ロケール設定による自動設定

Django はロケール設定に基づいて THOUSAND_SEPARATOR を自動的に設定できます。

settings.py

USE_L10N = True

テンプレート

{% load i18n %}

<h1>数字の表示</h1>

<p>{{ 123456789 }}</p>

その他の区切り文字

THOUSAND_SEPARATOR には、カンマ以外にもスペースやドットなどの文字を設定できます。

settings.py

USE_L10N = True
USE_THOUSAND_SEPARATOR = True

# 千の位区切り文字をスペースに設定
THOUSAND_SEPARATOR = ' '

テンプレート

{% load i18n %}

<h1>数字の表示</h1>

<p>{{ 123456789 }}</p>

テンプレートフィルターによるフォーマット

テンプレートフィルター intcomma や localize を使用して、数字をフォーマットできます。

テンプレート

{% load i18n %}

<h1>数字の表示</h1>

<p>{{ 123456789|intcomma }}</p>
<p>{{ 123456789|localize }}</p>

国際化機能の詳細

Django の国際化機能については、以下のドキュメントを参照してください。

Django settings.THOUSAND_SEPARATOR 以外の方法

テンプレートフィルター

テンプレート

{% load i18n %}

<h1>数字の表示</h1>

<p>{{ 123456789 }}</p>
<p>{{ 123456789|intcomma }}</p>
<p>{{ 123456789|localize }}</p>

**2. JavaScript ライブラリ

JavaScript ライブラリを使用して、数字をフォーマットできます。

テンプレート

<script src="https://cdnjs.cloudflare.com/ajax/libs/numeral.js/2.0.6/numeral.min.js"></script>

<h1>数字の表示</h1>

<p id="number"></p>

<script>
  var number = 123456789;

  // Numeral.js を使用して数字をフォーマット
  document.getElementById('number').innerHTML = numeral(number).format('0,000');
</script>

**3. カスタムフォーマット

独自のフォーマットロジックを実装するカスタムテンプレートタグやフィルターを作成できます。

テンプレート

{% load my_tags %}

<h1>数字の表示</h1>

<p>{{ 123456789|my_format }}</p>

my_tags.py

from django.template import Library

register = Library()

@register.filter
def my_format(value):
  # 独自のフォーマットロジック
  return f'{value:,}'

ロケール設定に基づいて数字をフォーマットできます。

settings.py

USE_L10N = True

テンプレート

{% load i18n %}

<h1>数字の表示</h1>

<p>{{ 123456789|localize }}</p>