AIcicle Records

Webサイトの閲覧数やアプリのダウンロード数、金額などを表示するとき、「1234567」とそのまま表示するよりも「1.2M」と表示した方が、ぐっと直感的で分かりやすくなりますよね。

今回は、そんな数値の単位表記をPythonで簡単に実現する方法をご紹介します。コピペしてすぐに使える関数を作成しましたので、ぜひ活用してください！

実装コード

1
def format_unit(num, precision=1):
2
    """数値をK, M, G, Tなどの単位表記に変換"""
3
    if not isinstance(num, (int, float)):
4
        raise TypeError("数値ではありません。")
5

6
    if num == 0:
7
        return "0"
8

9
    # 負数の処理
10
    sign = '-' if num < 0 else ''
11
    num = abs(num)
12

13
    # 単位リスト（大きい順）
14
    units = [
15
        (1_000_000_000_000, 'T'),  # テラ
18 collapsed lines
16
        (1_000_000_000, 'G'),      # ギガ
17
        (1_000_000, 'M'),          # メガ
18
        (1_000, 'K'),              # キロ
19
    ]
20

21
    for unit_value, unit_symbol in units:
22
        if num >= unit_value:
23
            value = num / unit_value
24
            formatted_value = f'{value:.{precision}f}'
25

26
            # 小数点以下が0の場合は整数表示
27
            if formatted_value.endswith(f'.{"0" * precision}'):
28
                formatted_value = f'{int(value)}'
29

30
            return f'{sign}{formatted_value}{unit_symbol}'
31

32
    # 1000未満はそのまま
33
    return f'{sign}{int(num) if num == int(num) else num}'

使い方と実行結果

この関数を使うと、こんな風に数値を変換できます。

1
print(format_unit(1234))          # → 1.2K  ← すっきり！
2
print(format_unit(1000000))       # → 1M   ← 一目瞭然！
3
print(format_unit(1850000, 2))    # → 1.85M ← 精度も自由自在
4
print(format_unit(1234567890))    # → 1.2G  ← 10億超えもお任せ
5
print(format_unit(-5432))         # → -5.4K ← マイナスも対応

precisionパラメータにより、小数点以下の表示桁数を柔軟に調整できます。

実装のポイント

単位定義の順序設計

1
units = [
2
    (1_000_000_000_000, 'T'), # テラ（1兆）
3
    (1_000_000_000, 'G'),     # ギガ（10億）
4
    (1_000_000, 'M'),         # メガ（100万）
5
    (1_000, 'K'),             # キロ（1千）
6
]

重要： 単位リストは降順（大きい順）で定義する必要があります。こうすることで、例えば 1,234,567 という数値が来たときに、まず T (1兆) や G (10億) のチェックをスキップし、M (100万) で正しく判定されるようになります。

動的フォーマット処理

Python 3.6から導入された f-string を使うと、文字列のフォーマットがとても簡単に書けます。

1
formatted_value = f'{value:.{precision}f}'

f-string記法を活用しています。{変数名:.{桁数}f} のように書くことで、変数を指定した小数点以下の桁数で表示できます。

表示最適化ロジック

1
if formatted_value.endswith(f'.{"0" * precision}'):
2
    formatted_value = f'{int(value)}'