【Java】String.formatとMessageFormatの違い

2025年6月6日2025年7月11日

Javaで文字列を整形する方法として、String.format と MessageFormat のどちらを使うべきか迷ったことはありませんか？

たとえば、ログ出力やデバッグ用のメッセージには String.format、多言語対応が必要なUIメッセージには MessageFormat が適していると言われますが、実際には両者の違いがあいまいなまま使われているケースも少なくありません。

この記事では、Java歴10年以上の現役エンジニアが、実務経験に基づき両者の使い分けポイントや落とし穴をわかりやすく解説します。違いをしっかり理解することで、より保守性の高いコードを書くための一助となれば幸いです。

String.formatの特徴と使いどころ

String.format は、C言語由来のフォーマット記法（%s, %d, %f など）を用いて文字列を整形するJava標準のAPIです。簡潔で高速、かつ柔軟に書式を指定できるため、日常的な開発で広く利用されています。

主な特徴

C言語に近い記法で直感的に使える
数値や小数点、桁揃えなどの整形に強い
プレースホルダー（%の順番）に順序の柔軟性がない

使用例

String pattern = "%sさんは%d歳です。";
String result = String.format(pattern, "田中", 30);
// → "田中さんは30歳です。"

向いている場面

ログ出力やコンソール表示
テストコードや一時的なデバッグ用の出力
英語や固定形式の出力が求められるケース

MessageFormatの特徴と使いどころ

MessageFormat は、Javaが提供する国際化（i18n）対応の文字列整形APIです。{0}, {1} といった番号付きのプレースホルダーを使い、ResourceBundleなどと組み合わせて多言語対応メッセージを構築できます。

プレースホルダーに渡された値は、ロケールに応じて自動的に整形されるため、日付や数値の出力にも柔軟に対応可能です。多言語対応アプリケーションやUI表示メッセージにおいて非常に有用です。

主な特徴

{0}, {1} のように、位置指定でプレースホルダーを使う
ロケールに応じた数値や日付の整形が可能
ResourceBundle との連携が容易で、国際化に最適

使用例

String pattern = "{0}さんは{1}歳です。";
String result = MessageFormat.format(pattern, "田中", 30);
// → "田中さんは30歳です。"

向いている場面

画面上に表示されるユーザー向けのメッセージ
複数言語対応が必要なアプリケーション
プロパティファイルを利用したメッセージの管理

補足：ResourceBundleとの組み合わせ例

welcome.message=ようこそ、{0}さん！

ResourceBundle bundle = ResourceBundle.getBundle("messages", Locale.JAPAN);
String pattern = bundle.getString("welcome.message");
String result = MessageFormat.format(pattern, "田中");
// → "ようこそ、田中さん！"

このように MessageFormat は、Javaの国際化機能と相性が非常に良く、ビジネス向けシステムでも広く使われています。

注意点：MessageFormat の落とし穴

MessageFormat にはいくつか注意すべき点があります。特に、シングルクォート（’）が特殊な意味を持つことに注意してください。

たとえば、「I’m Taro Yamada.」のようなメッセージに ' を含めたい場合、エスケープしないと正しく表示されません。

// ❌ NGパターン
String pattern = "I'm {0}."; // ← 正しく表示されない

// ✅ OKパターン
String pattern = "I''m {0}.";

シングルクォートは、MessageFormat ではエスケープ文字として扱われるため、表示したい場合は '' と二重にする必要があります。

このような落とし穴があるため、テンプレートに定数文字列を埋め込む際は注意が必要です。

String.format と MessageFormat の比較

両者の違いを一覧で整理しました。用途や仕様の違いを理解し、自分のニーズに合ったAPIを選びましょう。

項目	String.format	MessageFormat
記法スタイル	`%s`, `%d`, `%f` など（printf形式）	`{0}`, `{1}` など（位置指定）
国際化対応	弱い（ロケール指定は可能）	強い（ResourceBundle と併用可能）
整形の柔軟性	桁数やフォーマット指定に柔軟	ロケールに基づく整形が中心
適した用途	ログ出力、開発用メッセージ、数値整形	ユーザー表示、国際化されたUI、メッセージファイル