C# DateTime Format: Standart ve Özel Biçim String'leri, Kültür, ISO 8601

DateTime.ToString(format) bir tarihi metne çevirir. Biçim ya bir standart biçim string'idir (tam deseni kültürden gelen d ya da o gibi tek bir harf) ya da yyyy, MM ve HH gibi belirteçlerden oluşturulan özel bir desendir. Aynı string'ler interpolation'da, $"{date:yyyy-MM-dd}", ve string.Format'ta çalışır.

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

Çıktı:

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

Bu sayfadaki örnekler çıktının her makinede aynı olması için CultureInfo.InvariantCulture verir; o olmadan ToString geçerli kültürü kullanır ve bu, ay adlarını, ayırıcıları ve hatta takvimi değiştirebilir.

Özel biçim belirteçleri

Özel bir biçim, belirli harflerin tarihin parçalarını temsil ettiği bir desendir. Büyük/küçük harfe duyarlıdırlar: M ay, m dakikadır; H 24 saatlik, h 12 saatlik saattir.

Diğer her karakter olduğu gibi kopyalanır. Buna belirteç olmayan harfler de dahildir; "YYYY-DD"'nin sessizce YYYY-DD yazdırması bu yüzdendir: .NET'te büyük Y ya da D belirteci yoktur.

Tek başına tek bir harf özel değil standart bir biçim olarak okunur: ToString("d") gün numarası değil kısa tarih desenidir. Yalnızca günü almak için ToString("%d") yazın ya da Day property'sini kullanın.

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

Çıktı:

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

Standart biçim string'leri

Standart biçimler, asıl deseni kültür tarafından tanımlanan tek harflerdir. Kullanıcılara gösterilen metin için doğru seçimdirler, çünkü her kültür kendi geleneklerini bedavaya alır.

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

Çıktı:

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 ve r her kültürde aynı metni üretir; bu da onları log'lar, dosya adları ve veri alışverişi için güvenli kılar. Bir DateTime üzerinde u ve r'nin değeri UTC'ye dönüştürmediğine dikkat edin; olduğu gibi yazdırıp UTC olarak etiketlerler, bu yüzden değer yerelse önce ToUniversalTime() çağırın (ya da DateTime.UtcNow kullanın). (Bir DateTimeOffset üzerinde dönüştürürler.)

Kültür çıktıyı değiştirir

Standart biçimler, ay ve gün adları ve / ile : ayırıcılarının hepsi kültürden gelir. ToString'e ikinci argüman olarak bir kültür verin:

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

Çıktı:

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

Kültür verisi donmuş değildir. Linux ve macOS'taki .NET onu sisteme kurulu ICU kütüphanesinden okur, .NET 5'ten beri Windows 10 ve sonrasındaki .NET de öyle yapar (.NET Framework Windows'un kendi NLS verisini kullanır); bu yüzden bir desen sürümler ve platformlar arasında biraz değişebilir: örneğin yeni ICU sürümleri ABD kısa saat biçiminde "PM"'den önce düz bir boşluk yerine dar bir bölünmez boşluk koyar ve bazıları İspanyolca kısa tarihleri baştaki sıfır olmadan verir. Gösterim için biçimlendirilmiş metni asla parse etmemek için bir neden daha.

Buradan iki kural çıkar. Bir insanın okuduğu metin için onun kültürüyle biçimlendirin (bir sunucuda sunucununkiyle değil, istekten gelenle) ve standart biçimleri tercih edin; böylece Alman bir okuyucu 09.10.2026, Amerikalı bir okuyucu 10/9/2026 görür. Bir programın okuduğu metin için CultureInfo.InvariantCulture ve yyyy-MM-dd ya da o gibi belirsiz olmayan bir desen kullanın. Geçerli kültürle yazılıp başka bir makinede parse edilen bir tarih, yer değiştirmiş gün ve ayların klasik kaynağıdır.

ISO 8601 ve "o" ile gidiş dönüş

Gidiş dönüş biçimi "o" her tick'i ve dilim bilgisini yazar, bu yüzden metni parse etmek Kind dahil tam olarak aynı DateTime'ı geri verir:

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

Çıktı:

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

Z son eki UTC'yi işaretler; Kind'ı Unspecified olan bir DateTime son ek almaz; yerel bir saat ya da bir DateTimeOffset farkını alır (+02:00). Kind'ın korunması için DateTimeStyles.RoundtripKind ile parse edin. JSON serializer'ları, veritabanları ve JavaScript'in Date'i bu biçimi okur.

TimeSpan biçimlendirmek

TimeSpan'in kendi, daha küçük özel belirteç kümesi vardır: d (günler), hh, mm, ss ve fff. DateTime'ın aksine : ve . dahil her literal karakter ters eğik çizgiyle kaçırılmalı ya da tırnak içine alınmalıdır:

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

Çıktı:

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

Bir TimeSpan biçimindeki hh saat bileşenidir (0 ile 23 arası), bu yüzden 27 saatlik bir süre 03 olarak yazdırılır. Bir günün üzerindeki toplamlar için son satırdaki gibi TotalHours'tan hesaplayın. Ters eğik çizgi olmadan elapsed.ToString("hh:mm") bir FormatException fırlatır.

Yaygın hatalar

• Ay için mm. "yyyy-mm-dd" ortaya dakikaları yazdırır: 2026-30-09. Ay MM'dir.
• tt olmadan hh. "hh:mm" AM ya da PM olmayan 12 saatlik bir saattir, bu yüzden 06:30 belirsizdir. 24 saatlik zaman için HH kullanın.
• YYYY ve DD. .NET'te belirteç değildirler; olduğu gibi yazdırılırlar. yyyy ve dd kullanın.
• Veri için bir desende /. Kültürün tarih ayırıcısıdır. Tırnak içine alın ya da invariant kültürü kullanın.
• Log'larda ya da dosyalarda varsayılan ToString(). Biçim makineye bağlıdır. Bir biçim ve bir kültür verin.
• UTC olarak etiketlenmiş yerel saat. "u", "r" ve elle yazılmış bir 'Z' dönüştürmez; önce dönüştürün.
• Yazdığınızdan farklı bir desenle parse etmek. Veri için biçim string'lerini tek bir sabitte tutun ve onu hem ToString hem ParseExact ile kullanın.