Python format()完全ガイド – 文字列フォーマットの基礎から応用まで

Pythonにおける文字列フォーマットは、動的な文字列生成において欠かせない機能です。format()メソッドは、古い%フォーマットに代わる柔軟で強力な文字列フォーマット手法として広く使用されています。この記事では、format()メソッドの基本から高度な使用法まで、実践的なサンプルコードとともに詳しく解説します。

format()メソッドとは

format()メソッドは、Python 2.6で導入された文字列フォーマット機能で、文字列内のプレースホルダー{}に値を埋め込むことができます。従来の%フォーマットよりも読みやすく、より多くの機能を提供します。

基本構文

"文字列{プレースホルダー}".format(値)

基本的な使い方

1. 単純な値の埋め込み

name = "太郎"
message = "こんにちは、{}さん！".format(name)
print(message)  # こんにちは、太郎さん！

2. 複数の値の埋め込み

name = "太郎"
age = 25
message = "{}さんは{}歳です".format(name, age)
print(message)  # 太郎さんは25歳です

3. 位置指定

text = "{1}と{0}と{1}".format("りんご", "みかん")
print(text)  # みかんとりんごとみかん

名前付きプレースホルダー

キーワード引数の使用

message = "{name}さんの年齢は{age}歳です".format(name="花子", age=30)
print(message)  # 花子さんの年齢は30歳です

辞書を使った値の指定

person = {"name": "次郎", "age": 28}
message = "{name}さんは{age}歳です".format(**person)
print(message)  # 次郎さんは28歳です

リストやタプルの要素アクセス

data = ["Python", 3.9]
message = "{0[0]}のバージョンは{0[1]}です".format(data)
print(message)  # Pythonのバージョンは3.9です

数値フォーマット

小数点の桁数指定

pi = 3.14159
formatted = "円周率は{:.2f}です".format(pi)
print(formatted)  # 円周率は3.14です

整数の桁数指定（0埋め）

number = 42
formatted = "番号: {:04d}".format(number)
print(formatted)  # 番号: 0042

三桁区切り

amount = 1234567
formatted = "金額: {:,}円".format(amount)
print(formatted)  # 金額: 1,234,567円

パーセント表示

ratio = 0.8567
formatted = "成功率: {:.1%}".format(ratio)
print(formatted)  # 成功率: 85.7%

文字列の配置とパディング

左寄せ・右寄せ・中央寄せ

text = "Python"
print("'{:<10}'".format(text))  # 'Python    '（左寄せ）
print("'{:>10}'".format(text))  # '    Python'（右寄せ）
print("'{:^10}'".format(text))  # '  Python  '（中央寄せ）

埋め文字の指定

text = "Python"
print("'{:*<10}'".format(text))  # 'Python****'
print("'{:=^10}'".format(text))  # '==Python=='

数値の符号表示

positive = 42
negative = -42
print("{:+d}".format(positive))  # +42
print("{:+d}".format(negative))  # -42
print("{: d}".format(positive))  # ' 42'（正数の場合は空白）

進数変換

2進数・8進数・16進数

number = 255
print("2進数: {:b}".format(number))   # 2進数: 11111111
print("8進数: {:o}".format(number))   # 8進数: 377
print("16進数: {:x}".format(number))  # 16進数: ff
print("16進数: {:X}".format(number))  # 16進数: FF

プレフィックス付き表示

number = 255
print("2進数: {:#b}".format(number))   # 2進数: 0b11111111
print("8進数: {:#o}".format(number))   # 8進数: 0o377
print("16進数: {:#x}".format(number))  # 16進数: 0xff

日付と時刻のフォーマット

datetime オブジェクトのフォーマット

from datetime import datetime
now = datetime.now()
formatted = "{:%Y年%m月%d日 %H:%M:%S}".format(now)
print(formatted)  # 2025年07月29日 14:30:45

曜日の表示

from datetime import datetime
now = datetime.now()
formatted = "{:%Y-%m-%d (%a)}".format(now)
print(formatted)  # 2025-07-29 (Tue)

オブジェクトの属性アクセス

オブジェクトの属性を直接参照

class Person:
    def __init__(self, name, age):
        self.name = name
        self.age = age

person = Person("田中", 35)
message = "{.name}さんは{.age}歳です".format(person, person)
print(message)  # 田中さんは35歳です

より簡潔な書き方

class Person:
    def __init__(self, name, age):
        self.name = name
        self.age = age

person = Person("佐藤", 40)
message = "{0.name}さんは{0.age}歳です".format(person)
print(message)  # 佐藤さんは40歳です

高度なフォーマット指定

動的な幅指定

width = 10
text = "Python"
formatted = "{:{width}}".format(text, width=width)
print(f"'{formatted}'")  # '    Python'

動的な精度指定

precision = 3
pi = 3.14159
formatted = "{:.{prec}f}".format(pi, prec=precision)
print(formatted)  # 3.142

複合的なフォーマット

name = "Python"
version = 3.9
usage = 0.789
result = "{0:<10} | v{1:.1f} | {2:>6.1%}".format(name, version, usage)
print(result)  # Python     | v3.9 |  78.9%

実践的な使用例

1. テーブル形式の出力

data = [("Python", 3.9, 85.2), ("Java", 17.0, 92.1), ("JavaScript", 2021, 78.9)]
print("{:<12} | {:>8} | {:>6}".format("言語", "バージョン", "人気度"))
print("-" * 30)
for lang, ver, pop in data:
    print("{:<12} | {:>8} | {:>5.1f}%".format(lang, ver, pop))

2. ログメッセージの生成

from datetime import datetime
level = "ERROR"
message = "データベース接続失敗"
timestamp = datetime.now()
log = "[{:%Y-%m-%d %H:%M:%S}] {:<5}: {}".format(timestamp, level, message)
print(log)  # [2025-07-29 14:30:45] ERROR: データベース接続失敗

3. 設定ファイルの生成

config = {
    "host": "localhost",
    "port": 8080,
    "debug": True,
    "timeout": 30.5
}
template = """
サーバー設定:
  ホスト: {host}
  ポート: {port:d}
  デバッグ: {debug}
  タイムアウト: {timeout:.1f}秒
""".strip()
result = template.format(**config)
print(result)

4. 金融データの表示

stocks = [("AAPL", 150.25, 2.5), ("GOOGL", 2800.75, -1.2), ("MSFT", 300.50, 0.8)]
print("{:<6} | {:>8} | {:>7}".format("銘柄", "価格", "変動率"))
print("-" * 25)
for symbol, price, change in stocks:
    print("{:<6} | {:>8.2f} | {:>+6.1f}%".format(symbol, price, change))

format()とf-string（f文字列）の比較

format()メソッド

name = "Python"
version = 3.9
message = "{}のバージョンは{}です".format(name, version)
print(message)  # Pythonのバージョンは3.9です

f-string（推奨）

name = "Python"
version = 3.9
message = f"{name}のバージョンは{version}です"
print(message)  # Pythonのバージョンは3.9です

複雑なフォーマットでの比較

# format()
pi = 3.14159
result1 = "円周率: {:.3f}".format(pi)

# f-string
result2 = f"円周率: {pi:.3f}"
print(result1, result2)  # 両方とも: 円周率: 3.142

エラーハンドリング

一般的なエラーと対処法

# KeyError: 存在しないキーを指定
try:
    result = "{name}さん".format(age=25)
except KeyError as e:
    print(f"キーエラー: {e}")
    result = "{age}歳の方".format(age=25)

IndexError: インデックス範囲外

try:
    result = "{0}と{1}と{2}".format("A", "B")  # {2}が存在しない
except IndexError as e:
    print(f"インデックスエラー: {e}")
    result = "{0}と{1}".format("A", "B")

安全なフォーマット関数

def safe_format(template, *args, **kwargs):
    """安全な文字列フォーマット"""
    try:
        return template.format(*args, **kwargs)
    except (KeyError, IndexError, ValueError) as e:
        return f"フォーマットエラー: {e}"

result = safe_format("{name}さんは{age}歳", name="田中")
print(result)  # フォーマットエラー: 'age'

パフォーマンスの考慮

大量データでのフォーマット

import time

# format()メソッド
start = time.time()
results1 = ["{}: {}".format(i, i**2) for i in range(10000)]
time1 = time.time() - start

# f-string（より高速）
start = time.time()
results2 = [f"{i}: {i**2}" for i in range(10000)]
time2 = time.time() - start

print(f"format(): {time1:.4f}秒")
print(f"f-string: {time2:.4f}秒")

テンプレートの再利用

# 効率的: テンプレートを再利用
template = "名前: {name}, 年齢: {age}"
data = [{"name": "太郎", "age": 25}, {"name": "花子", "age": 30}]
results = [template.format(**person) for person in data]

国際化対応

ロケール対応の数値フォーマット

import locale

# 日本のロケール設定（環境依存）
try:
    locale.setlocale(locale.LC_ALL, 'ja_JP.UTF-8')
    amount = 1234567.89
    formatted = locale.format_string("%.2f", amount, grouping=True)
    print(f"金額: {formatted}")
except locale.Error:
    print("ロケール設定に失敗")

多言語対応のテンプレート

templates = {
    "ja": "こんにちは、{name}さん！",
    "en": "Hello, {name}!",
    "es": "¡Hola, {name}!"
}

def greet(name, lang="ja"):
    return templates.get(lang, templates["en"]).format(name=name)

print(greet("田中", "ja"))  # こんにちは、田中さん！
print(greet("Smith", "en"))  # Hello, Smith!

ベストプラクティス

1. 読みやすさを重視

# 良い例: 名前付きプレースホルダー
user_info = "ユーザー: {username}, レベル: {level}, スコア: {score:,}".format(
    username="player1", level=15, score=98765
)

# 避けるべき例: 位置指定のみ
user_info = "ユーザー: {}, レベル: {}, スコア: {:,}".format("player1", 15, 98765)

2. エラー処理の実装

def format_user_data(template, **data):
    """ユーザーデータの安全なフォーマット"""
    required_keys = ["name", "age"]
    for key in required_keys:
        if key not in data:
            raise ValueError(f"必須キー '{key}' が不足しています")
    
    return template.format(**data)

try:
    result = format_user_data("{name}さん({age}歳)", name="田中", age=25)
    print(result)
except ValueError as e:
    print(f"エラー: {e}")

3. パフォーマンスを考慮した選択

# Python 3.6以降ではf-stringを推奨
name = "Python"
version = 3.9

# format()よりもf-stringの方が高速で読みやすい
message = f"{name} {version}の機能は素晴らしい！"

レガシーコードとの互換性

%フォーマットからの移行

# 古い%フォーマット
old_style = "Hello, %s! You are %d years old." % ("Alice", 25)

# format()への移行
new_style = "Hello, {}! You are {} years old.".format("Alice", 25)

# さらに現代的なf-string
modern_style = f"Hello, {'Alice'}! You are {25} years old."

段階的な移行方法

def migrate_format(old_template, *args):
    """古い%フォーマットをformat()に変換（簡易版）"""
    # %sを{}に置換（簡易実装）
    new_template = old_template.replace("%s", "{}")
    new_template = new_template.replace("%d", "{}")
    return new_template.format(*args)

result = migrate_format("Name: %s, Age: %d", "John", 30)
print(result)  # Name: John, Age: 30

まとめ

format()メソッドは、Pythonにおける文字列フォーマットの重要な機能です。基本的な値の埋め込みから、複雑な数値フォーマット、オブジェクトの属性アクセスまで、幅広い用途に対応できます。

主なポイント：

• 基本構文: "テンプレート{}".format(値)
• 柔軟な指定方法: 位置指定、名前付き、辞書展開
• 豊富なフォーマットオプション: 数値、日付、配置、進数変換
• 実践的活用: ログ、テーブル、設定ファイル、国際化対応
• パフォーマンス: Python 3.6以降はf-stringを推奨
• エラー処理: KeyError、IndexErrorの適切な処理

現在ではf-stringがより推奨されますが、format()メソッドは既存コードの保守や特定の用途において依然として重要な役割を果たしています。両方の特徴を理解して、適切な場面で使い分けることが重要です。

参考リンク

• Python公式ドキュメント – 文字列フォーマット
• PEP 3101 – Advanced String Formatting
• Python公式ドキュメント – f-string

■プロンプトだけでオリジナルアプリを開発・公開してみた！！

■AI時代の第一歩！「AI駆動開発コース」はじめました！

テックジム東京本校で先行開始。

■テックジム東京本校

「武田塾」のプログラミング版といえば「テックジム」。
講義動画なし、教科書なし。「進捗管理とコーチング」で効率学習。
より早く、より安く、しかも対面型のプログラミングスクールです。

＜短期講習＞5日で5万円の「Pythonミニキャンプ」開催中。

＜月1開催＞放送作家による映像ディレクター養成講座

＜オンライン無料＞ゼロから始めるPython爆速講座