Javaの国際化対応の基礎: java.textパッケージ徹底解説

Javaは、初期の段階から「Write Once, Run Anywhere (一度書けば、どこでも動く)」という思想のもと、プラットフォーム非依存性を大きな特徴としてきました。この思想は、異なるOSだけでなく、異なる言語や文化圏でアプリケーションを動作させる「国際化（Internationalization / i18n）」と「地域化（Localization / l10n）」の対応にも繋がっています。

その中核を担ってきたのが、今回解説するjava.textパッケージです。このパッケージは、日付、時刻、数値、メッセージといった、言語や文化によって表現形式が異なるデータを、ユーザーのロケールに合わせて適切にフォーマット（整形）するための強力なクラス群を提供します。

本記事では、java.textパッケージの主要なクラスの使い方を、具体的なコード例を交えながら徹底的に解説します。古くから存在するパッケージですが、その仕組みを理解することは、Javaによる国際化対応の基礎を固める上で非常に重要です。特に、レガシーシステムの改修や、java.timeパッケージではカバーしきれない特定の機能を利用する際に、その知識が役立つでしょう。

第一章: 日付と時刻のフォーマット – DateFormatとSimpleDateFormat

アプリケーションで現在の日付や時刻を扱う際、その表示形式は国や地域によって大きく異なります。例えば、「2025年7月12日」は、アメリカでは “July 12, 2025″、イギリスでは “12 July 2025” と表記されるのが一般的です。java.text.DateFormatは、このようなロケールに応じた日付・時刻のフォーマットと解析を行うための抽象クラスです。

DateFormatの基本的な使い方

DateFormatのインスタンスは、コンストラクタではなく、静的なファクトリメソッドを使って取得します。これにより、ロケールに応じたデフォルトのフォーマットを持つインスタンスを簡単に得られます。

import java.text.DateFormat;
import java.util.Date;
import java.util.Locale;

public class DateFormatExample {
    public static void main(String[] args) {
        Date now = new Date();

        // 日本のロケールで日付/時刻フォーマッタを取得
        DateFormat jpFormat = DateFormat.getDateTimeInstance(DateFormat.LONG, DateFormat.LONG, Locale.JAPAN);
        System.out.println("日本: " + jpFormat.format(now));

        // アメリカのロケールで日付/時刻フォーマッタを取得
        DateFormat usFormat = DateFormat.getDateTimeInstance(DateFormat.LONG, DateFormat.LONG, Locale.US);
        System.out.println("アメリカ: " + usFormat.format(now));

        // フランスのロケールで日付のみのフォーマッタを取得
        DateFormat frFormat = DateFormat.getDateInstance(DateFormat.FULL, Locale.FRANCE);
        System.out.println("フランス: " + frFormat.format(now));
    }
}
      

getDateTimeInstanceやgetDateInstanceメソッドの引数には、FULL, LONG, MEDIUM, SHORTといったスタイル定数を指定でき、表示の詳細度を調整できます。

カスタムフォーマットを実現するSimpleDateFormat

より柔軟なフォーマットを実現したい場合は、DateFormatの具象クラスであるjava.text.SimpleDateFormatを使用します。コンストラクタに「パターン文字列」を渡すことで、日付や時刻を自由な形式に整形できます。

import java.text.SimpleDateFormat;
import java.util.Date;

public class SimpleDateFormatExample {
    public static void main(String[] args) {
        Date now = new Date();

        // カスタムパターンでフォーマット
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy年MM月dd日(E) HH時mm分ss秒 z");
        System.out.println(sdf.format(now));

        // 文字列からDateオブジェクトへの解析 (parse)
        try {
            String dateString = "2025/07/12 10:30:00";
            SimpleDateFormat parser = new SimpleDateFormat("yyyy/MM/dd HH:mm:ss");
            Date parsedDate = parser.parse(dateString);
            System.out.println("解析結果: " + parsedDate);
        } catch (java.text.ParseException e) {
            e.printStackTrace();
        }
    }
}
      

モダンJavaの標準: java.time.DateTimeFormatter

Java 8 (2014年3月リリース) で導入されたjava.timeパッケージは、これまでの日付・時刻APIの問題点を抜本的に解決するものです。特にjava.time.format.DateTimeFormatterは、SimpleDateFormatの代替となるクラスで、以下のような大きなメリットがあります。

• イミュータブル（不変）: 一度生成したら状態が変わらないため、スレッドセーフです。安心して共有できます。
• 明確なAPI: 用途に応じたクラス（LocalDate, LocalTime, LocalDateTimeなど）が用意されており、直感的に操作できます。

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

public class DateTimeFormatterExample {
    public static void main(String[] args) {
        // スレッドセーフなので、静的フィールドとして保持しても安全
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss");

        LocalDateTime now = LocalDateTime.now();
        String formattedDateTime = now.format(formatter);
        System.out.println("フォーマット結果: " + formattedDateTime);

        LocalDateTime parsedDateTime = LocalDateTime.parse("2025/07/12 10:30:00", formatter);
        System.out.println("解析結果: " + parsedDateTime);
    }
}
      

レガシーコードの保守などでSimpleDateFormatを扱わざるを得ない場合を除き、日付・時刻のフォーマットには必ずjava.time.DateTimeFormatterを使いましょう。

第二章: 数値のフォーマット – NumberFormatとDecimalFormat

数値の表現もまた、ロケールに依存します。例えば、小数点の記号は日本では「.」（ピリオド）ですが、ドイツなどでは「,」（カンマ）が使われます。また、桁区切りの記号も同様です。java.text.NumberFormatは、このような数値、通貨、パーセンテージのフォーマットを行うための抽象クラスです。

NumberFormatの基本的な使い方

DateFormatと同様に、NumberFormatもファクトリメソッドを使ってインスタンスを取得します。

import java.text.NumberFormat;
import java.util.Locale;

public class NumberFormatExample {
    public static void main(String[] args) {
        double number = 1234567.89;

        // デフォルトロケール（日本）でのフォーマット
        NumberFormat nfJp = NumberFormat.getInstance(Locale.JAPAN);
        NumberFormat cfJp = NumberFormat.getCurrencyInstance(Locale.JAPAN);
        NumberFormat pfJp = NumberFormat.getPercentInstance(Locale.JAPAN);

        System.out.println("日本の数値: " + nfJp.format(number));
        System.out.println("日本の通貨: " + cfJp.format(number));
        System.out.println("日本のパーセント: " + pfJp.format(0.75));

        System.out.println("---");

        // アメリカのロケールでのフォーマット
        NumberFormat nfUs = NumberFormat.getInstance(Locale.US);
        NumberFormat cfUs = NumberFormat.getCurrencyInstance(Locale.US);
        System.out.println("アメリカの数値: " + nfUs.format(number));
        System.out.println("アメリカの通貨: " + cfUs.format(number));
    }
}
      

カスタムフォーマットを実現するDecimalFormat

より詳細な数値フォーマットを定義したい場合は、NumberFormatの具象クラスであるjava.text.DecimalFormatを使用します。こちらもSimpleDateFormatと同様に、パターン文字列を使ってフォーマットを自由にカスタマイズできます。

import java.text.DecimalFormat;

public class DecimalFormatExample {
    public static void main(String[] args) {
        double num1 = 1234.5;
        double num2 = 0.12;

        // ゼロ埋めと桁区切り
        DecimalFormat df1 = new DecimalFormat("¥#,##0.00");
        System.out.println(df1.format(num1)); // ¥1,234.50
        System.out.println(df1.format(num2)); // ¥0.12

        // パーセント表示
        DecimalFormat df2 = new DecimalFormat("#.##%");
        System.out.println(df2.format(0.7567)); // 75.67%

        // 正の数と負の数でフォーマットを分ける
        DecimalFormat df3 = new DecimalFormat("+#,##0;-#,##0");
        System.out.println(df3.format(12345));  // +12,345
        System.out.println(df3.format(-12345)); // -12,345

        // 文字列から数値への解析
        try {
            String currencyStr = "¥1,234";
            DecimalFormat parser = new DecimalFormat("¥#,##0");
            Number parsedNum = parser.parse(currencyStr);
            System.out.println("解析結果: " + parsedNum.doubleValue()); // 1234.0
        } catch (java.text.ParseException e) {
            e.printStackTrace();
        }
    }
}
      

第三章: 複合メッセージの組み立て – MessageFormat

アプリケーションでは、「ファイルが3個見つかりました」や「ディスク容量が残り15%です」のように、文章の中に動的な値を埋め込みたいケースが頻繁にあります。java.text.MessageFormatは、このような複合メッセージを安全かつ柔軟に生成するためのクラスです。

単純な文字列連結（+演算子）やString.formatと異なり、MessageFormatはプレースホルダーにインデックスを付け、さらにそのプレースホルダーに対してNumberFormatやDateFormatを適用できるため、国際化対応に非常に優れています。

import java.text.MessageFormat;
import java.util.Date;

public class MessageFormatExample {
    public static void main(String[] args) {
        // 基本的な使い方
        String pattern1 = "本日 {0,date,long} の {1,time,short} 時点、エラーが{2,number,integer}件発生しました。";
        Object[] args1 = {new Date(), new Date(), 5};
        String message1 = MessageFormat.format(pattern1, args1);
        System.out.println(message1);

        // 異なるロケールでのメッセージ生成
        String pattern2 = "User ''{0}'' logged in. Current disk usage is {1,number,percent}.";
        Object[] args2 = {"admin", 0.78};
        String message2 = MessageFormat.format(pattern2, args2);
        System.out.println(message2);
    }
}
      

パターン内の{...}がプレースホルダーです。{インデックス, フォーマットタイプ, フォーマットスタイル}という形式で、埋め込むデータのフォーマットを詳細に指定できます。

第四章: 条件に応じたフォーマット – ChoiceFormat

MessageFormatをさらに強力にするのが、java.text.ChoiceFormatです。これは、数値の範囲に応じて表示する文字列を切り替えることができる特殊なフォーマットです。例えば、英語では「1 file」と「2 files」のように、数によって単語の単数形・複数形を使い分ける必要があります。ChoiceFormatは、このようなルールをエレガントに記述するために使用します。

ChoiceFormatは、通常MessageFormatと組み合わせて使われます。

import java.text.MessageFormat;
import java.text.ChoiceFormat;

public class ChoiceFormatExample {
    public static void main(String[] args) {
        // ChoiceFormatを直接利用する例
        double[] limits = {0, 1, 2};
        String[] formats = {"no files", "one file", "many files"};
        ChoiceFormat choiceFormat = new ChoiceFormat(limits, formats);
        
        System.out.println("0 -> " + choiceFormat.format(0));
        System.out.println("1 -> " + choiceFormat.format(1));
        System.out.println("2 -> " + choiceFormat.format(2));

        System.out.println("---");

        // MessageFormatと組み合わせて利用する例
        String pattern = "There {0,choice,0#are no files|1#is one file|1<are {0,number,integer} files} in the directory.";
        MessageFormat msgFormat = new MessageFormat(pattern);

        System.out.println(msgFormat.format(new Object[]{0}));
        System.out.println(msgFormat.format(new Object[]{1}));
        System.out.println(msgFormat.format(new Object[]{5}));
    }
}
      

MessageFormat内のパターンでは、limit#stringの形式で境界値と文字列のペアを|で区切って記述します。1<は「1より大きい」を意味します。これにより、if文の連鎖のようなロジックをフォーマットパターンの中に埋め込むことができ、コードから表示ロジックを分離するのに役立ちます。

第五章: 言語ルールに準じた文字列比較 – Collator

String.compareTo()メソッドによる文字列比較は、単純なUnicodeのコードポイント順で行われます。これは、アルファベット順のソートには有効ですが、日本語のように複数の文字種（ひらがな、カタカナ、漢字）を持つ言語や、アクセント記号を持つ言語では、人間が期待する自然な順序にはなりません。

java.text.Collatorは、ロケールの言語的ルールに基づいて文字列を比較するためのクラスです。

import java.text.Collator;
import java.util.Arrays;
import java.util.Locale;

public class CollatorExample {
    public static void main(String[] args) {
        String[] words = {"アップル", "アプリ", "りんご", "リンゴ"};

        // Unicode順でのソート (期待通りにならない)
        String[] sortedByUnicode = words.clone();
        Arrays.sort(sortedByUnicode);
        System.out.println("Unicode順: " + Arrays.toString(sortedByUnicode));

        // Collatorを使った日本語ロケールでのソート
        Collator collator = Collator.getInstance(Locale.JAPANESE);
        String[] sortedByCollator = words.clone();
        Arrays.sort(sortedByCollator, collator);
        System.out.println("Collator順: " + Arrays.toString(sortedByCollator));

        // 比較の強度を設定
        collator.setStrength(Collator.PRIMARY);
        System.out.println("「あ」と「ア」の比較 (PRIMARY): " + collator.compare("あ", "ア")); // 0 (等しい)

        collator.setStrength(Collator.TERTIARY);
        System.out.println("「あ」と「ア」の比較 (TERTIARY): " + collator.compare("あ", "ア")); // -1 (「あ」が小さい)
    }
}
      

Collatorを使うと、「ひらがな」「カタカナ」「漢字」を適切に並べ替えたり、「あ」と「ア」、「半角」と「全角」を同一視するかどうかといった、比較の「強度（Strength）」を調整したりすることが可能です。

• PRIMARY: 基本文字の違いのみを区別（例：「a」と「b」）。大文字・小文字やアクセントの違いは無視。
• SECONDARY: アクセントの違いを区別（例：「a」と「á」）。
• TERTIARY: 大文字・小文字の違いを区別（例：「a」と「A」）。（デフォルト）
• IDENTICAL: Unicodeコードポイントレベルでの違いも区別。

データベースに保存された名前を一覧表示する際など、ユーザーにとって自然な順序でソートする必要がある場合に、Collatorは不可欠なツールとなります。