Format DateTime C#: Format String Standar dan Custom, Culture, ISO 8601

DateTime.ToString(format) mengubah tanggal menjadi teks. Format-nya bisa berupa format string standar (satu huruf seperti d atau o, yang pola pastinya berasal dari culture) atau pola custom yang disusun dari specifier seperti yyyy, MM, dan HH. String yang sama juga berlaku di interpolasi, $"{date:yyyy-MM-dd}", dan di string.Format.

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var shipped = new DateTime(2026, 10, 9, 18, 30, 7, 45);
        var inv = CultureInfo.InvariantCulture;

        Console.WriteLine(shipped.ToString("yyyy-MM-dd", inv));
        Console.WriteLine(shipped.ToString("yyyy-MM-dd HH:mm:ss", inv));
        Console.WriteLine(shipped.ToString("dd/MM/yyyy", inv));
        Console.WriteLine(shipped.ToString("MMM d, yyyy", inv));
        Console.WriteLine(shipped.ToString("dddd, MMMM d", inv));
        Console.WriteLine(shipped.ToString("h:mm tt", inv));
        Console.WriteLine(shipped.ToString("HH:mm:ss.fff", inv));
        Console.WriteLine($"Shipped {shipped:yyyy-MM-dd} at {shipped:HH:mm}");
    }
}

Output:

2026-10-09
2026-10-09 18:30:07
09/10/2026
Oct 9, 2026
Friday, October 9
6:30 PM
18:30:07.045
Shipped 2026-10-09 at 18:30

Contoh di halaman ini memberikan CultureInfo.InvariantCulture supaya output-nya sama di setiap mesin; tanpa itu, ToString memakai culture saat ini, yang bisa mengubah nama bulan, pemisah, bahkan kalendernya.

Specifier format custom

Format custom adalah pola yang huruf-huruf tertentunya mewakili bagian dari tanggal. Huruf-huruf ini peka huruf besar-kecil: M adalah bulan dan m adalah menit, H adalah jam format 24 jam dan h jam format 12 jam.

Karakter lain disalin apa adanya. Termasuk huruf yang bukan specifier, dan begitulah "YYYY-DD" diam-diam mencetak YYYY-DD: tidak ada specifier Y atau D huruf besar di .NET.

Satu huruf yang berdiri sendiri dibaca sebagai format standar, bukan custom: ToString("d") adalah pola tanggal pendek, bukan nomor tanggal. Untuk mendapat tanggalnya saja, tulis ToString("%d") atau pakai property Day.

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var d = new DateTime(2026, 10, 9, 18, 30, 7);
        var inv = CultureInfo.InvariantCulture;

        Console.WriteLine(d.ToString("d", inv));             // standard short date
        Console.WriteLine(d.ToString("%d", inv));            // custom: day of month
        Console.WriteLine(d.ToString("yyyyMMdd_HHmmss", inv)); // for file names
        Console.WriteLine(d.ToString("'Week of' MMM d", inv));
        Console.WriteLine(d.ToString("HH'h'mm", inv));
        Console.WriteLine(d.ToString("yyyy-MM-ddTHH:mm:ss", inv));
        Console.WriteLine(d.ToString("YYYY-DD", inv));      // not specifiers: copied
    }
}

Output:

10/09/2026
9
20261009_183007
Week of Oct 9
18h30
2026-10-09T18:30:07
YYYY-DD

Format string standar

Format standar adalah huruf tunggal yang pola sebenarnya ditentukan oleh culture. Format ini pilihan yang tepat untuk teks yang ditampilkan ke pengguna, karena setiap culture otomatis mendapat konvensinya sendiri.

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var d = new DateTime(2026, 10, 9, 18, 30, 7, DateTimeKind.Utc);
        var inv = CultureInfo.InvariantCulture;

        foreach (string f in new[] { "d", "D", "f", "g", "G", "M", "Y", "t", "T", "o", "s", "u", "r" })
        {
            Console.WriteLine($"{f}  {d.ToString(f, inv)}");
        }

        var us = new CultureInfo("en-US");
        Console.WriteLine($"en-US d: {d.ToString("d", us)}, D: {d.ToString("D", us)}");
    }
}

Output:

d  10/09/2026
D  Friday, 09 October 2026
f  Friday, 09 October 2026 18:30
g  10/09/2026 18:30
G  10/09/2026 18:30:07
M  October 09
Y  2026 October
t  18:30
T  18:30:07
o  2026-10-09T18:30:07.0000000Z
s  2026-10-09T18:30:07
u  2026-10-09 18:30:07Z
r  Fri, 09 Oct 2026 18:30:07 GMT
en-US d: 10/9/2026, D: Friday, October 9, 2026

o, s, u, dan r menghasilkan teks yang sama di setiap culture, jadi aman untuk log, nama file, dan pertukaran data. Perhatikan bahwa pada DateTime, u dan r tidak mengonversi nilainya ke UTC; keduanya mencetak nilai apa adanya dan memberinya label UTC, jadi panggil ToUniversalTime() dulu (atau pakai DateTime.UtcNow) kalau nilainya waktu lokal. (Pada DateTimeOffset, keduanya memang mengonversi.)

Culture mengubah output

Format standar, nama bulan dan hari, serta pemisah / dan : semuanya berasal dari culture. Berikan culture sebagai argumen kedua ke ToString:

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var d = new DateTime(2026, 10, 9, 18, 30, 0);
        string[] cultures = { "en-US", "en-GB", "de-DE", "fr-FR", "ja-JP" };

        foreach (string name in cultures)
        {
            var c = new CultureInfo(name);
            Console.WriteLine($"{name}  {d.ToString("d", c)}");
        }

        var de = new CultureInfo("de-DE");
        Console.WriteLine(d.ToString("D", de));
        Console.WriteLine(d.ToString("D", new CultureInfo("fr-FR")));
        Console.WriteLine(d.ToString("dd/MM/yyyy", de));      // "/" becomes "."
        Console.WriteLine(d.ToString("dd'/'MM'/'yyyy", de));  // quoted: a real slash
    }
}

Output:

en-US  10/9/2026
en-GB  09/10/2026
de-DE  09.10.2026
fr-FR  09/10/2026
ja-JP  2026/10/09
Freitag, 9. Oktober 2026
vendredi 9 octobre 2026
09.10.2026
09/10/2026

Data culture tidak beku. .NET di Linux dan macOS membacanya dari library ICU yang terpasang di sistem, dan sejak .NET 5 begitu juga .NET di Windows 10 ke atas (.NET Framework memakai data NLS milik Windows sendiri), jadi sebuah pola bisa sedikit berubah antarversi dan antarplatform: misalnya, rilis ICU terbaru menaruh narrow no-break space, bukan spasi biasa, sebelum "PM" di format waktu pendek AS, dan sebagian memberi tanggal pendek bahasa Spanyol tanpa nol di depan. Itu satu alasan lagi untuk tidak pernah mem-parse teks yang diformat untuk tampilan.

Ada dua aturan yang mengikutinya. Untuk teks yang dibaca manusia, format dengan culture mereka (di server, culture dari request, bukan culture server) dan utamakan format standar, supaya pembaca Jerman melihat 09.10.2026 dan pembaca Amerika 10/9/2026. Untuk teks yang dibaca program, pakai CultureInfo.InvariantCulture dan pola yang tidak ambigu seperti yyyy-MM-dd atau o. Tanggal yang ditulis dengan culture saat ini lalu di-parse di mesin lain adalah sumber klasik tertukarnya tanggal dan bulan.

ISO 8601 dan round-trip dengan "o"

Format round-trip "o" menulis setiap tick ditambah informasi zona, jadi mem-parse teksnya mengembalikan DateTime yang persis sama, termasuk Kind-nya:

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var inv = CultureInfo.InvariantCulture;
        var utc = new DateTime(2026, 10, 9, 18, 30, 7, 45, DateTimeKind.Utc);
        var unspecified = new DateTime(2026, 10, 9, 18, 30, 7, 45);
        var offset = new DateTimeOffset(2026, 10, 9, 20, 30, 7, TimeSpan.FromHours(2));

        string stored = utc.ToString("o", inv);
        Console.WriteLine(stored);
        Console.WriteLine(unspecified.ToString("o", inv));
        Console.WriteLine(offset.ToString("o", inv));

        DateTime back = DateTime.Parse(stored, inv, DateTimeStyles.RoundtripKind);
        Console.WriteLine(back == utc);
        Console.WriteLine(back.Kind);

        Console.WriteLine(utc.ToString("yyyy-MM-ddTHH:mm:ssK", inv));    // no fractions
        Console.WriteLine(offset.ToString("yyyy-MM-dd HH:mm zzz", inv));
    }
}

Output:

2026-10-09T18:30:07.0450000Z
2026-10-09T18:30:07.0450000
2026-10-09T20:30:07.0000000+02:00
True
Utc
2026-10-09T18:30:07Z
2026-10-09 20:30 +02:00

Suffix Z menandai UTC; DateTime dengan Kind Unspecified tidak mendapat suffix; waktu lokal atau DateTimeOffset mendapat offset-nya (+02:00). Parse dengan DateTimeStyles.RoundtripKind supaya Kind-nya tetap terjaga. Serializer JSON, database, dan Date milik JavaScript semuanya bisa membaca format ini.

Memformat TimeSpan

TimeSpan punya sekumpulan specifier custom sendiri yang lebih kecil: d (hari), hh, mm, ss, dan fff. Berbeda dengan DateTime, setiap karakter literal, termasuk : dan ., harus di-escape dengan backslash atau diberi tanda kutip:

using System;

class Program
{
    static void Main()
    {
        var elapsed = new TimeSpan(1, 3, 25, 9, 120);   // 1 day 3:25:09.120

        Console.WriteLine(elapsed.ToString());
        Console.WriteLine(elapsed.ToString("c"));
        Console.WriteLine(elapsed.ToString(@"hh\:mm\:ss"));        // hours component only
        Console.WriteLine(elapsed.ToString(@"d\.hh\:mm"));
        Console.WriteLine(elapsed.ToString(@"mm\:ss\.fff"));
        Console.WriteLine($"{(int)elapsed.TotalHours}:{elapsed.Minutes:D2}");  // 27:25
    }
}

Output:

1.03:25:09.1200000
1.03:25:09.1200000
03:25:09
1.03:25
25:09.120
27:25

hh di format TimeSpan adalah komponen jam (0 sampai 23), jadi durasi 27 jam dicetak sebagai 03. Untuk total di atas satu hari, hitung dari TotalHours seperti di baris terakhir. elapsed.ToString("hh:mm") tanpa backslash melempar FormatException.

Kesalahan umum

• mm untuk bulan. "yyyy-mm-dd" mencetak menit di tengah: 2026-30-09. Bulan adalah MM.
• hh tanpa tt. "hh:mm" adalah jam format 12 jam tanpa AM atau PM, jadi 06:30 menjadi ambigu. Pakai HH untuk waktu format 24 jam.
• YYYY dan DD. Keduanya bukan specifier di .NET; keduanya dicetak apa adanya. Pakai yyyy dan dd.
• / di dalam pola untuk data. Karakter ini adalah pemisah tanggal milik culture. Beri tanda kutip atau pakai invariant culture.
• ToString() default di log atau file. Format-nya bergantung pada mesin. Berikan format dan culture.
• Waktu lokal yang diberi label UTC. "u", "r", dan 'Z' yang ditulis manual tidak mengonversi; konversi dulu.
• Mem-parse dengan pola yang berbeda dari pola saat menulis. Simpan format string untuk data di satu konstanta dan pakai untuk ToString maupun ParseExact.