Javaで0埋め（ゼロパディング）を実装する方法：数値・文字列の書式指定を解説

Javaを利用した開発において、数値を特定の桁数に揃える「0埋め（ゼロパディング）」は、頻繁に必要となる処理の一つです。

例えば、日付や時刻の表示を「2024/01/01」のように2桁に固定する場合や、管理番号を「ID0001」のように一定の長さに保つ場合など、データの可読性向上やソート順の維持を目的に広く利用されます。

本記事では、Javaの標準ライブラリから最新の構文、外部ライブラリに至るまで、状況に応じた最適な0埋めの実装方法を詳しく解説します。

0埋め（ゼロパディング）の基本概念

0埋めとは、数値や文字列の桁数が指定した長さに満たない場合に、不足している前方の部分を「0」で埋める処理を指します。

コンピュータの世界では、数値として比較する場合「1」と「10」は正しく比較されますが、文字列として比較すると「1, 10, 2」という順序でソートされてしまうことがあります。

このような問題を防ぐために、桁数を「01, 02, 10」と統一することで、文字列比較においても正しい順序を保つことが可能になります。

Javaにはこの処理を実現するための手段が複数用意されており、要件（パフォーマンス重視、コードの簡潔さ重視など）に合わせて選択することが重要です。

String.formatメソッドによる0埋め

Javaで最も一般的かつ汎用的な方法が、String.format() メソッドを使用する方法です。

C言語の printf 関数に近い形式で、書式を指定して文字列を生成できます。

基本的な使い方と書式

String.format() の第一引数には書式文字列を、第二引数以降には埋め込みたい値を指定します。

0埋めを行う際の書式は %0[桁数]d という形式になります。

• %：書式指定子の開始を示します。
• 0：埋める文字に「0」を指定します。
• [桁数]：最終的な全体の桁数を指定します。
• d：対象が整数（10進数）であることを示します。

以下に、整数を5桁で0埋めする例を示します。

public class ZeroPaddingExample {
    public static void main(String[] args) {
        int number = 123;
        
        // 5桁で0埋めする
        String padded = String.format("%05d", number);
        
        System.out.println("元の値: " + number);
        System.out.println("0埋め後: " + padded);
    }
}

元の値: 123
0埋め後: 00123

浮動小数点数（小数）の0埋め

小数の場合、全体の桁数だけでなく、小数部の桁数も指定することが一般的です。

書式は %0[全体桁数].[小数部桁数]f となります。

ここで注意が必要なのは、「全体桁数」には小数点（.）も含まれるという点です。

public class FloatPaddingExample {
    public static void main(String[] args) {
        double value = 1.23;
        
        // 全体7桁、小数部3桁で0埋め（小数点は1桁分としてカウントされる）
        String padded = String.format("%07.3f", value);
        
        System.out.println("0埋め後: " + padded);
    }
}

0埋め後: 001.230

DecimalFormatクラスによる0埋め

数値のフォーマットに特化した java.text.DecimalFormat クラスを使用する方法も有効です。

この方法は、同じフォーマットを繰り返し利用する場合にパフォーマンス面で有利になります。

DecimalFormatのパターン指定

パターンの文字列に「0」を配置することで、その位置が数値で埋められない場合に0を表示するように設定できます。

import java.text.DecimalFormat;

public class DecimalFormatExample {
    public static void main(String[] args) {
        int number = 45;
        
        // 4桁の0埋めパターンを作成
        DecimalFormat df = new DecimalFormat("0000");
        String result = df.format(number);
        
        System.out.println("結果: " + result);
    }
}

結果: 0045

DecimalFormat はスレッドセーフではないため、マルチスレッド環境で共有して使用する場合は、適切に同期化するか ThreadLocal を利用するなどの工夫が必要です。

しかし、単純な数値の整形においては、直感的なパターン指定が可能なため非常に使いやすい手法です。

Java 15以降のString.formattedメソッド

Java 15からは、インスタンスメソッドとして formatted() が追加されました。

これにより、String.format() よりも簡潔に記述できるようになっています。

public class ModernJavaExample {
    public static void main(String[] args) {
        int count = 7;
        
        // Stringのインスタンスに対して直接フォーマットを適用
        String result = "%03d".formatted(count);
        
        System.out.println("Java 15以降の書き方: " + result);
    }
}

Java 15以降の書き方: 007

このメソッドは内部的に String.format() を呼び出しているため、使用できる書式指定子は同じです。

可読性が高く、モダンなJavaの書き方として推奨されています。

文字列（String）を0埋めする方法

ここまでは「数値」を対象とした0埋めを解説してきましたが、元々が文字列（String）である値を0埋めしたい場合もあります。

例えば、既に文字列として保持されている「”123″」を「”00123″」にするケースです。

数値に変換してからString.formatを使う

最も確実なのは、一度数値にパースしてから書式指定を行う方法です。

public class StringToZeroPadding {
    public static void main(String[] args) {
        String input = "88";
        
        // 一度数値に変換
        int num = Integer.parseInt(input);
        String result = String.format("%04d", num);
        
        System.out.println("結果: " + result);
    }
}

変換せずに文字列操作で対応する

数値以外の文字が含まれている可能性がある場合や、数値への変換コストを避けたい場合は、replace や StringBuilder、あるいはJava 11で追加された repeat() メソッドを組み合わせて実装します。

public class ManualPadding {
    public static void main(String[] args) {
        String text = "ABC";
        int targetLength = 6;
        
        if (text.length() < targetLength) {
            // 不足分を計算して0を繰り返す
            String padded = "0".repeat(targetLength - text.length()) + text;
            System.out.println("結果: " + padded);
        }
    }
}

結果: 000ABC

外部ライブラリ（Apache Commons Lang）の活用

プロジェクトですでに Apache Commons Lang が導入されている場合は、StringUtils.leftPad() を使用するのが非常に便利です。

import org.apache.commons.lang3.StringUtils;

public class CommonsExample {
    public static void main(String[] args) {
        String val = "55";
        
        // 第2引数に合計桁数、第3引数に埋める文字を指定
        String padded = StringUtils.leftPad(val, 5, "0");
        
        System.out.println("Apache Commons結果: " + padded);
    }
}

Apache Commons結果: 00055

このメソッドの利点は、null安全（nullを渡しても例外が発生せず、適切に処理される）であることと、数値変換の手間がないことです。

実装方法の比較と使い分け

紹介した各手法の特性を以下の表にまとめました。

基本的には String.format または formatted() を使用し、パフォーマンスがボトルネックになる場合や数値以外の文字列を扱う場合に他の手法を検討するのがベストプラクティスです。

注意点：負の数の0埋め

0埋めを行う際、負の数を扱うと挙動に注意が必要です。

String.format("%05d", -123) を実行した場合、結果は「-0123」となります。

System.out.println(String.format("%05d", -123)); 
// 出力: -0123

符号を含めて5桁（マイナス記号 + 数字4桁）になるように調整されます。

もし「符号を考慮せずに絶対値に対して0埋めをしたい」といった特殊な要件がある場合は、事前に Math.abs() で絶対値を取得するなどの個別対応が必要になります。

まとめ

Javaにおける0埋め（ゼロパディング）は、標準ライブラリの進化により非常に簡単に実装できるようになりました。

数値の場合

String.format("%0桁数d", 値) または Java 15以降の formatted() を使用する。

大量の数値を整形する場合

DecimalFormat を使い回すことで効率化を図る。

文字列をそのまま0埋めする場合

String.repeat() や外部ライブラリの StringUtils.leftPad() を検討する。

出力形式を統一することは、システムの品質を保つ上で欠かせないステップです。

利用しているJavaのバージョンや、対象となるデータの特性に合わせて、最適なメソッドを選択してください。