C#の文字列補間とString.Format：書式指定子、配置、カルチャ

文字列補間は、リテラルのテキストと式から文字列を組み立てます。リテラルの前に $ を付け、任意のC#の式を波かっこの中に置くと、その値がテキストに変換されて挿入されます。

using System;

class Program
{
    static void Main()
    {
        string customer = "Maya";
        int items = 3;
        decimal price = 4.5m;

        Console.WriteLine($"Hello, {customer}!");
        Console.WriteLine($"{items} items at {price} = {items * price}");
        Console.WriteLine($"Name has {customer.Length} letters, upper: {customer.ToUpper()}");
        Console.WriteLine($"Free shipping: {(items * price > 10 ? "yes" : "no")}");
    }
}

出力：

Hello, Maya!
3 items at 4.5 = 13.5
Name has 4 letters, upper: MAYA
Free shipping: yes

補間はC# 6で導入されました。コンパイラはそれを string.Format や string.Concat の呼び出し（C# 10以降は、より効率的なハンドラーのコード）に変換するので、手で文字列を組み立てるより遅くなることはありません。

最後の行の条件式にはかっこが必要です。補間の穴の中ではコロンが書式指定子を始めるので、かっこのない {x > 10 ? "yes" : "no"} はコンパイルエラーになります。

書式指定子

式の後にコロンと書式文字列を置くと、値の書き方を制御できます。同じ書式文字列が ToString("...") や string.Format でも使えます。

using System;

class Program
{
    static void Main()
    {
        decimal total = 1234567.891m;
        int orderId = 42;
        double ratio = 0.8127;

        Console.WriteLine($"{total:F2}");     // fixed-point, 2 decimals
        Console.WriteLine($"{total:N2}");     // with thousands separators
        Console.WriteLine($"{total:N0}");     // no decimals, rounded
        Console.WriteLine($"{orderId:D5}");   // integer padded to 5 digits
        Console.WriteLine($"{255:X}");        // hexadecimal
        Console.WriteLine($"{255:x4}");       // lowercase hex, 4 digits
        Console.WriteLine($"{total:E2}");     // scientific
        Console.WriteLine($"{ratio:F3}");
        Console.WriteLine($"{ratio:0.0%}");   // custom: percent with 1 decimal
        Console.WriteLine($"{total:#,##0.00}"); // custom pattern
        Console.WriteLine($"{7.5:000.0}");    // leading zeros
        Console.WriteLine($"{3.10m:0.##}");   // drop trailing zeros
    }
}

出力：

1234567.89
1,234,567.89
1,234,568
00042
FF
00ff
1.23E+006
0.813
81.3%
1,234,567.89
007.5
3.1

標準のコードは次のとおりで、それぞれの後に精度の数値を付けられます。

カスタムパターンは、プレースホルダーから書式を組み立てます。0 は常に表示される桁、# は意味がある場合にだけ表示される桁、. は小数点、数値の中の , は桁区切りを有効にし、% は100を掛けます。"0.##" は小数点以下を最大2桁表示して末尾のゼロを落とし、"#,##0.00" は会計で定番の書式です。

すべての数値の書式設定は、表示する値を丸めます。変数そのものは変わりません。値がちょうど中間にある場合（2.25を小数点以下1桁で表示する場合）、ランタイムや型によって丸め方が異なることがあるので、規則が重要なら、先に Math.Round(value, 1, MidpointRounding.AwayFromZero) で明示的に丸めてから書式設定します。

補間での日付

DateTime の値も、同じように日付の書式文字列を受け付けます。

using System;

class Program
{
    static void Main()
    {
        var shipped = new DateTime(2026, 9, 24, 16, 5, 0);

        Console.WriteLine($"{shipped:yyyy-MM-dd}");
        Console.WriteLine($"{shipped:dd/MM/yyyy HH:mm}");
        Console.WriteLine($"{shipped:ddd, MMM d}");
        Console.WriteLine($"Shipped at {shipped:HH:mm} on {shipped:dddd}");

        TimeSpan eta = TimeSpan.FromMinutes(130);
        Console.WriteLine($"ETA {eta:hh\\:mm}");
        Console.WriteLine($"{eta.TotalHours:F1} hours");
    }
}

出力：

2026-09-24
24/09/2026 16:05
Thu, Sep 24
Shipped at 16:05 on Thursday
ETA 02:10
2.2 hours

TimeSpan のカスタム書式では、リテラルの文字をバックスラッシュでエスケープする必要があり、通常の文字列リテラルでは \\: と書きます。日付のコード（yyyy、MM、HH、tt など）の一覧と、よくある間違い（mm は分、MM は月）は、DateTimeの書式にあります。

配置とパディング

式の後のカンマで、最小のフィールド幅を設定します。正の数は右寄せ、負の数は左寄せです。書式と組み合わせると、プレーンテキストで表をそろえられます。

using System;

class Program
{
    static void Main()
    {
        var names = new[] { "Espresso", "Latte", "Hot chocolate" };
        var prices = new[] { 2.4m, 3.6m, 4.25m };
        var sold = new[] { 118, 64, 9 };

        Console.WriteLine($"{"Item",-14}|{"Price",7}|{"Sold",5}");
        Console.WriteLine(new string('-', 28));
        for (int i = 0; i < names.Length; i++)
        {
            Console.WriteLine($"{names[i],-14}|{prices[i],7:F2}|{sold[i],5}");
        }
    }
}

出力：

Item          |  Price| Sold
----------------------------
Espresso      |   2.40|  118
Latte         |   3.60|   64
Hot chocolate |   4.25|    9

構文は {expression,alignment:format} で、配置が先、書式が後です。幅より長い値は切り詰められず、行の残りを押し出します。補間の外では、PadLeft と PadRight が同じパディングを行います。

波かっこのエスケープ

波かっこをそのまま出力するには、2つ重ねます：{{ と }}。出力がJSON、CSS、コードの場合に必要になります。

using System;

class Program
{
    static void Main()
    {
        int id = 42;
        string name = "Ana";

        Console.WriteLine($"{{ \"id\": {id}, \"name\": \"{name}\" }}");
        Console.WriteLine($"Set literal: {{1, 2, 3}}");
        Console.WriteLine($"{{{id}}}");   // a value wrapped in braces
    }
}

出力：

{ "id": 42, "name": "Ana" }
Set literal: {1, 2, 3}
{42}

このようにJSONを手で組み立てるのは、ちょっとしたログの行なら問題ありません。本物のJSONにはシリアライザーを使います。name の中の引用符や特殊文字を正しく扱ってくれます。

string.Formatと複合書式

C# 6より前は、番号付きのプレースホルダーと引数のリストを受け取る string.Format で書式設定していました。同じ複合書式の構文は、Console.WriteLine、StringBuilder.AppendFormat、TextWriter.Write でも使えます。

using System;

class Program
{
    static void Main()
    {
        string item = "Notebook";
        decimal price = 3.5m;
        int qty = 4;

        string line = string.Format("{0} x{1}: {2:F2}", item, qty, price * qty);
        Console.WriteLine(line);

        Console.WriteLine("{0,-10}|{1,6:F2}", item, price);   // alignment and format
        Console.WriteLine("{0} {0} {1}", "echo", "!");        // an index can repeat

        string template = "Dear {0}, your order #{1:D6} has shipped.";
        Console.WriteLine(string.Format(template, "Leo", 731));
    }
}

出力：

Notebook x4: 14.00
Notebook  |  3.50
echo echo !
Dear Leo, your order #000731 has shipped.

コードでは補間を優先します。値が現れる場所にあるので、プレースホルダーが間違った引数を指すことがありません。テンプレートがデータである場合、たとえばリソースファイルから読み込んだ翻訳済みのメッセージには、今でも string.Format が適しています。対応する引数のないプレースホルダーの番号（引数が2つなのに {2}）は、実行時に FormatException を投げます。

カルチャ：区切り文字と通貨の制御

補間、ToString、string.Format は、既定ではすべてスレッドの現在のカルチャを使います。ドイツ語に設定されたマシンでは {1234.5:N2} は 1.234,50 になり、米国では 1,234.50 になります。通貨の書式 C はカルチャの記号を使います。カルチャを明示的に選ぶには、補間文字列を FormattableString として受け取り、プロバイダーを指定して書式設定します。

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        decimal amount = 1234.5m;
        var us = new CultureInfo("en-US");
        var de = new CultureInfo("de-DE");

        FormattableString line = $"Total: {amount:N2}";
        Console.WriteLine(line.ToString(us));
        Console.WriteLine(line.ToString(de));

        Console.WriteLine(amount.ToString("C", us));
        Console.WriteLine(string.Format(de, "{0:N2}", amount));

        // For files, logs and URLs: always the invariant culture
        string csv = FormattableString.Invariant($"{amount},{0.75}");
        Console.WriteLine(csv);
    }
}

出力：

Total: 1,234.50
Total: 1.234,50
$1,234.50
1.234,50
1234.5,0.75

人が読むテキストにはユーザーのカルチャを、別のプログラムが読むものには CultureInfo.InvariantCulture を使います。ドイツ語のマシンで現在のカルチャを使って書き出したCSVは数値の中にカンマを含み、他の環境では読めません。.NET 6以降では、string.Create(CultureInfo.InvariantCulture, $"...") が、中間のオブジェクトなしで FormattableString.Invariant と同じことを行います。

逐語的な補間文字列と生の補間文字列

$ は @ と組み合わせて逐語的な補間文字列にできます。バックスラッシュはそのままの文字になり、文字列は複数行にまたがれます。C# 8以降はどちらの順序（$@ または @$）も受け付けますが、C# 6と7では $@ が必要です。

using System;

class Program
{
    static void Main()
    {
        string user = "ana";
        int year = 2026;
        Console.WriteLine($@"C:\Users\{user}\Reports\{year}\summary.txt");
        Console.WriteLine($@"Report for {user}
Year: {year}");
    }
}

出力：

C:\Users\ana\Reports\2026\summary.txt
Report for ana
Year: 2026

C# 11では生の補間文字列が追加されました。$ が1つなら、波かっこはいつもどおり式を表します。$$ なら、1つの波かっこはそのままの文字になり、式には2つの波かっこが必要になるので、JSONやコードのテンプレートが読みやすくなります。

// C# 11 and later
int id = 42;
string name = "Ana";
string json = $$"""
    {
      "id": {{id}},
      "name": "{{name}}"
    }
    """;

C# 11では補間の穴の中で改行することも許されるようになったので、長い式や switch 式を複数行に分けられます。

よくある間違い

• $ を忘れる。 "Total: {total}" は波かっこをそのまま出力します。コンパイラは警告しません。
• 波かっこの中のかっこのない三項演算子。 コロンが書式の区切りとして読まれます。
• 機械が読む出力を現在のカルチャで書式設定する。 小数点のカンマはCSV、JSON、SQLを壊します。インバリアントカルチャを使います。
• お金に書式なしの ToString() を使う。 2.5m は 2.50 ではなく 2.5 と表示されます。F2、N2、C を使います。
• ループの中で補間を使って大きな文字列を組み立てる。 反復のたびに新しい文字列が作られます。StringBuilderか string.Join を使います。