String Interpolation dan String.Format di C#: Format Specifier, Alignment, Culture

String interpolation membangun string dari teks literal dan ekspresi. Beri awalan $ pada literal-nya, taruh ekspresi C# apa pun di dalam kurung kurawal, lalu nilainya diubah menjadi teks dan disisipkan:

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")}");
    }
}

Output:

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

Interpolation hadir di C# 6. Compiler mengubahnya menjadi pemanggilan string.Format atau string.Concat (atau, sejak C# 10, menjadi kode handler yang lebih efisien), jadi cara ini tidak lebih lambat daripada membangun string secara manual.

Ekspresi kondisional di baris terakhir butuh tanda kurung. Di dalam lubang interpolation, titik dua memulai format specifier, jadi {x > 10 ? "yes" : "no"} tanpa tanda kurung adalah error kompilasi.

Format specifier

Setelah ekspresi, titik dua dan sebuah string format mengatur cara nilainya ditulis. String format yang sama bisa dipakai dengan ToString("...") dan 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
    }
}

Output:

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

Kode standar, masing-masing bisa diikuti angka presisi:

Pola kustom menyusun format dari placeholder: 0 adalah digit yang selalu ditampilkan, # adalah digit yang hanya ditampilkan jika signifikan, . adalah titik desimal, , di dalam angka mengaktifkan pemisah kelompok, dan % mengalikan dengan 100. "0.##" menampilkan sampai dua angka desimal dan membuang nol di belakang; "#,##0.00" adalah format akuntansi klasik.

Semua pemformatan angka membulatkan nilai yang ditampilkan; variabelnya sendiri tidak berubah. Jika sebuah nilai tepat di tengah (2,25 yang ditampilkan dengan satu desimal), runtime dan tipe yang berbeda bisa membulatkannya secara berbeda, jadi jika aturan pembulatan itu penting, bulatkan dulu secara eksplisit dengan Math.Round(value, 1, MidpointRounding.AwayFromZero), lalu format.

Tanggal di dalam interpolation

Nilai DateTime menerima string format tanggal dengan cara yang sama:

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");
    }
}

Output:

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

Format kustom TimeSpan mengharuskan karakter literal diberi escape dengan backslash, yang di string literal biasa ditulis \\:. Daftar lengkap kode tanggal (yyyy, MM, HH, tt...) dan kesalahan yang sering dibuat orang (mm adalah menit, MM adalah bulan) ada di Format DateTime.

Alignment dan padding

Koma setelah ekspresi menentukan lebar minimum kolom. Angka positif membuat rata kanan, angka negatif membuat rata kiri. Jika digabung dengan format, cara ini bisa merapikan tabel dalam teks biasa:

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}");
        }
    }
}

Output:

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

Sintaksnya adalah {expression,alignment:format}: alignment lebih dulu, lalu format. Nilai yang lebih panjang dari lebarnya tidak dipotong; ia mendorong sisa barisnya ke kanan. PadLeft dan PadRight melakukan padding yang sama di luar interpolation.

Escape kurung kurawal

Untuk mencetak kurung kurawal apa adanya, gandakan: {{ dan }}. Ini sering dibutuhkan saat output-nya berupa JSON, CSS, atau kode:

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
    }
}

Output:

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

Membangun JSON secara manual seperti ini tidak masalah untuk satu baris log singkat; untuk JSON sungguhan, pakai serializer, yang menangani tanda kutip dan karakter khusus di dalam name dengan benar.

string.Format dan composite formatting

Sebelum C# 6, pemformatan dilakukan dengan string.Format, yang menerima placeholder bernomor dan daftar argumen. Sintaks composite format yang sama juga diterima oleh Console.WriteLine, StringBuilder.AppendFormat, dan 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));
    }
}

Output:

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

Di dalam kode, lebih baik pakai interpolation: nilainya berada tepat di tempat munculnya, jadi placeholder tidak mungkin menunjuk argumen yang salah. string.Format tetap menjadi alat yang tepat jika template-nya berupa data, seperti pesan terjemahan yang dimuat dari file resource. Indeks placeholder yang tidak punya argumen pasangannya ({2} dengan dua argumen) melempar FormatException saat program berjalan.

Culture: mengatur pemisah dan mata uang

Interpolation, ToString, dan string.Format secara default memakai culture yang sedang aktif di thread itu. Di komputer yang diatur ke bahasa Jerman, {1234.5:N2} menghasilkan 1.234,50; di Amerika Serikat hasilnya 1,234.50. Format mata uang C memakai simbol milik culture tersebut. Untuk memilih culture secara eksplisit, simpan interpolated string sebagai FormattableString lalu format dengan sebuah provider:

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);
    }
}

Output:

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

Pakai culture milik pengguna untuk teks yang dibaca orang, dan CultureInfo.InvariantCulture untuk apa pun yang dibaca program lain. File CSV yang ditulis dengan culture aktif di komputer berbahasa Jerman punya koma di dalam angka dan tidak bisa dibaca di tempat lain. Di .NET 6 dan sesudahnya, string.Create(CultureInfo.InvariantCulture, $"...") melakukan hal yang sama dengan FormattableString.Invariant tanpa object perantara.

Interpolated string verbatim dan raw

$ bisa digabung dengan @ untuk interpolated string verbatim: backslash dianggap literal dan string-nya boleh terdiri dari beberapa baris. C# 8 dan sesudahnya menerima urutan mana pun ($@ atau @$); C# 6 dan 7 mewajibkan $@:

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}");
    }
}

Output:

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

C# 11 menambahkan raw interpolated string. Dengan satu $, kurung kurawal menandai ekspresi seperti biasa. Dengan $$, kurung kurawal tunggal dianggap literal dan ekspresi butuh dua kurung kurawal, sehingga template JSON dan kode jadi mudah dibaca:

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

C# 11 juga mengizinkan baris baru di dalam lubang interpolation, jadi ekspresi yang panjang atau ekspresi switch bisa dipecah menjadi beberapa baris.

Kesalahan umum

• Lupa menulis $. "Total: {total}" mencetak kurung kurawalnya apa adanya. Compiler tidak memberi peringatan.
• Operator ternary tanpa tanda kurung di dalam kurung kurawal: titik duanya dibaca sebagai pemisah format.
• Memformat output yang dibaca mesin dengan culture yang sedang aktif. Koma desimal merusak CSV, JSON, dan SQL. Pakai invariant culture.
• Memakai ToString() tanpa format untuk uang. 2.5m dicetak sebagai 2.5, bukan 2.50. Pakai F2, N2, atau C.
• Membangun string besar dengan interpolation di dalam perulangan. Setiap iterasi membuat string baru; pakai StringBuilder atau string.Join.