Javaで「String.format」メソッドを使用して、数値をゼロパディング（ゼロ埋め）したり、文字列へ半角スペース埋めする方法をご紹介します。

formatメソッドの書式

引数	型	説明
第1引数	String format	書式文字列
第2引数	Object... args	書式文字列の書式指示子により参照される引数。書式指示子よりも引数が多い場合、余分な引数は無視される。引数の数は変動し、ゼロの場合もある。引数の最大数は、Java 仮想マシン仕様で定義されている Java 配列の最大次元により制限される。引数が null の場合、動作は変換に応じて異なる

発生する例外

• IllegalFormatException – 書式文字列が、不正な構文、所定の引数と互換性がない書式指示子、書式文字列に与えられた不適切な引数、あるいはほかの不正な条件を含む場合。
• NullPointerException – format が null の場合

用途別の記述例

用途	記述例	備考
文字列の先頭を空白埋めする	String.format("%6s", "abc")	指定文字列を最大6桁まで文字列の左側に空文字を追加します。
文字列の後ろへ空白埋めする	String.format("%-6s", "abc")	指定文字列を最大6桁まで文字列の右側に空文字を追加します。
数字の先頭を０埋めする	String.format("%06d", 123)	指定数字を最大6桁まで文字列の左側にゼロパディングします。
数字を3桁ごとにカンマ区切りする	String.format("%,d", 123456789)	指定数字を3桁毎にカンマ区切りします。

サンプルJavaソース

Java

@Test public void formatTest() { // 期待値 String expected1 = " abc"; String expected2 = "abc "; String expected3 = "000123"; String expected4 = "123,456,789"; // 実行 String result1 = String.format("%6s", "abc"); String result2 = String.format("%-6s", "abc"); String result3 = String.format("%06d", 123); String result4 = String.format("%,d", 123456789); // 検証 assertEquals("文字列が一致していません。", expected1, result1); assertEquals("文字列が一致していません。", expected2, result2); assertEquals("文字列が一致していません。", expected3, result3); assertEquals("文字列が一致していません。", expected4, result4); }

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

@Test public void formatTest() { // 期待値 String expected1 = "   abc"; String expected2 = "abc   "; String expected3 = "000123"; String expected4 = "123,456,789";   // 実行 String result1 = String.format("%6s", "abc"); String result2 = String.format("%-6s", "abc"); String result3 = String.format("%06d", 123); String result4 = String.format("%,d", 123456789);   // 検証     assertEquals("文字列が一致していません。", expected1, result1);     assertEquals("文字列が一致していません。", expected2, result2);     assertEquals("文字列が一致していません。", expected3, result3);     assertEquals("文字列が一致していません。", expected4, result4); }

String型項目に対してゼロパディングしたい場合、一旦formatで指定桁数に整えてからreplaceメソッドを使用する事でゼロパディング可能となります。


Java

@Test public void formatTest2() { // 期待値 String expected = "000123"; // 実行 String result = String.format("%6s", "123").replace(" ", "0"); // 検証 assertEquals("文字列が一致していません。", expected, result); }

1 2 3 4 5 6 7 8 9 10 11

@Test public void formatTest2() { // 期待値 String expected = "000123";   // 実行 String result = String.format("%6s", "123").replace(" ", "0");   // 検証     assertEquals("文字列が一致していません。", expected, result); }