C#で数値・文字列を0埋めする方法：ToStringや$記法、PadLeftの使い分けを解説

C#を用いた開発において、数値や文字列の桁数を一定に揃えるために「0」で埋める処理、いわゆる「0埋め（ゼロパディング）」は非常に頻繁に利用されるテクニックです。

ログの出力、伝票番号やシリアルコードの生成、ファイル名のソート順維持、日付のフォーマットなど、その用途は多岐にわたります。

C#には、この0埋めを実現するための方法が複数用意されており、状況に応じて最適な手法を選択することがコードの可読性や保守性を高める鍵となります。

本記事では、C#における代表的な0埋めの手法であるToStringメソッド、現代的な文字列補間（$記法）、そして文字列操作に特化したPadLeftメソッドの違いと使い分けについて、具体的なソースコードと共に詳しく解説します。

数値型を0埋めする基本：ToStringメソッド

数値を文字列に変換する際に最も一般的に利用されるのが、ToStringメソッドに「書式指定文字列」を渡す方法です。

この手法は、int型やlong型などの数値型に対して直接実行できるため、非常に直感的です。

標準数値書式指定子「D」を使用する方法

整数の0埋めにおいて、最も推奨されるのが標準数値書式指定子「D」です。

これは「Decimal」の略で、整数を10進数として扱い、指定した桁数に満たない場合に左側を0で埋めます。

using System;

public class Program
{
    public static void Main()
    {
        int number = 123;

        // 5桁で0埋めする
        string result = number.ToString("D5");

        Console.WriteLine($"元の数値: {number}");
        Console.WriteLine($"0埋め後: {result}");
    }
}

元の数値: 123
0埋め後: 00123

この方法の利点は、"D5"や"D10"といった形式で、「何桁にしたいか」を数値で直接指定できる点にあります。

ただし、「D」指定子は整数型（int, longなど）にしか使用できないという点に注意が必要です。

浮動小数点型（float, double）に対して使用するとランタイムエラーが発生します。

カスタム数値書式指定子「0」を使用する方法

より柔軟なフォーマットが必要な場合は、カスタム数値書式指定子の"0"記号を使用します。

指定した「0」の個数が、そのまま最低桁数として扱われます。

using System;

public class Program
{
    public static void Main()
    {
        int number = 45;

        // 4桁で0埋めする（0045）
        string result = number.ToString("0000");

        Console.WriteLine($"4桁指定: {result}");

        // 小数点を含む数値の場合
        double pi = 3.14;
        string piResult = pi.ToString("00.000"); // 整数部2桁、小数部3桁で固定

        Console.WriteLine($"小数の0埋め: {piResult}");
    }
}

4桁指定: 0045
小数の0埋め: 03.140

この手法は、小数点以下の桁数も固定して0埋めしたい場合に非常に有効です。

また、整数型以外にも適用できるため、汎用性が高いという特徴があります。

現代的な書き方：文字列補間（$記法）による0埋め

C# 6.0以降で導入された文字列補間（String Interpolation）を使用すると、コードがより簡潔かつ読みやすくなります。

変数を{ }で囲み、その後にコロン:を付けることで、ToStringと同様の書式指定を直接記述できます。

文字列補間での書式指定の例

using System;

public class Program
{
    public static void Main()
    {
        int userId = 789;
        int categoryCode = 5;

        // 文字列補間の中でD指定子を使用
        string formattedId = $"{userId:D6}";
        
        // 複数の変数を組み合わせてフォーマット
        string fullCode = $"CAT-{categoryCode:D3}-ID-{userId:D8}";

        Console.WriteLine($"ユーザーID: {formattedId}");
        Console.WriteLine($"完全コード: {fullCode}");
    }
}

ユーザーID: 000789
完全コード: CAT-005-ID-00000789

現在のC#開発において、この文字列補間は最も推奨される書き方です。

メソッド呼び出しを明示的に記述する必要がなく、文字列全体の構成が把握しやすいため、メンテナンス性が大幅に向上します。

文字列型（String）を0埋めする：PadLeftメソッド

これまでの方法は「数値型」を元にしていましたが、既に「文字列型」として存在しているデータに対して0埋めを行いたい場合には、String.PadLeftメソッドを使用します。

PadLeftの基本的な使い方

PadLeftは、文字列の全長を指定した文字数にし、足りない部分を左側に指定した文字（この場合は ‘0’）で埋めるメソッドです。

using System;

public class Program
{
    public static void Main()
    {
        string rawCode = "XY-99";

        // 全体の長さを10文字にし、左側を '0' で埋める
        string paddedCode = rawCode.PadLeft(10, '0');

        Console.WriteLine($"元の文字列: {rawCode}");
        Console.WriteLine($"PadLeft後: {paddedCode}");
    }
}

元の文字列: XY-99
PadLeft後: 00000XY-99

PadLeftを使用する際の注意点は、第一引数に指定するのは「追加する0の数」ではなく「全体の長さ」であることです。

もし元の文字列が既に指定した長さを超えている場合、文字列は切り捨てられず、そのままの状態で返されます。

各手法の比較と使い分けのガイドライン

開発現場でどの手法を選択すべきか迷った際は、以下の基準を参考にしてください。

パフォーマンスの観点

大量のデータをループ内で処理する場合、文字列補間やToStringは内部的に新しい文字列オブジェクトを生成するため、頻繁な実行はメモリ負荷（GCの発生）を招く可能性があります。

しかし、通常のビジネスアプリケーションであれば、それほど神経質になる必要はありません。

極限のパフォーマンスが求められる場合は、Span<char>やTryFormatメソッド、あるいはStringBuilderの活用を検討してください。

応用編：負の数や日付の0埋め

実務では単純な正の整数以外を扱うケースも多いため、いくつかの応用パターンを紹介します。

負の数値の扱い

負の数値に対して"D"書式指定子を使用すると、マイナス記号を含めて桁数が計算されるわけではなく、絶対値の部分に対して0埋めが行われ、その前にマイナス記号が付与されます。

using System;

public class Program
{
    public static void Main()
    {
        int negativeNum = -123;
        
        // "D6" を指定すると、符号を除いた数字部分が6桁になるよう0埋めされる
        Console.WriteLine(negativeNum.ToString("D6"));
    }
}

-000123

日付・時刻の0埋め

日付（DateTime）の月や日を2桁に揃えたい場合、数値としての0埋めではなく、日付専用のカスタム書式指定子を使用します。

using System;

public class Program
{
    public static void Main()
    {
        DateTime now = new DateTime(2026, 5, 7, 9, 5, 1);

        // yyyy(年), MM(月), dd(日), HH(時), mm(分), ss(秒)
        string formattedDate = $"{now:yyyy/MM/dd HH:mm:ss}";

        Console.WriteLine($"フォーマット済み日時: {formattedDate}");
    }
}

フォーマット済み日時: 2026/05/07 09:05:01

ここではMMやddのように、2文字重ねることで「1桁の場合は0を付けて2桁にする」という0埋め処理が自動的に適用されています。

まとめ

C#で数値や文字列を0埋めする方法は、数値型であれば文字列補間（$記法）における「D」や「0」指定子を使い、文字列型であれば「PadLeft」メソッドを利用するのがベストプラクティスです。

特に理由がない限り、現代のC#開発では可読性の高い文字列補間を優先的に選択することをお勧めします。

一方で、小数点の制御や負の数の扱い、日付フォーマットなど、特殊な要件がある場合には、それぞれの書式指定子が持つ特性を正しく理解して使い分けることが重要です。

今回紹介した各手法を適切に組み合わせることで、データの整合性を保ち、ユーザーにとって見やすいUIや正確なデータ出力を実現できるようになります。

ぜひ、自身のプロジェクトの要件に最適な方法を取り入れてみてください。