Standart tarih ve saat biçimi dizeleri

2025-03-22

Standart tarih ve saat biçim dizesi, bir DateTime veya DateTimeOffset değerinin metin gösterimini tanımlamak için biçim tanımlayıcısı olarak tek bir karakter kullanır. Boşluk da dahil olmak üzere birden fazla karakter içeren herhangi bir tarih ve saat biçim dizesi, özel tarih ve saat biçim dizesi olarak yorumlanır. Standart veya özel biçim dizesi iki şekilde kullanılabilir:

Biçimlendirme işleminden kaynaklanan dizeyi tanımlamak için.
Ayrıştırma işlemiyle bir DateTime veya DateTimeOffset değerine dönüştürülebilen bir tarih ve saat değerinin metin gösterimini tanımlamak için.

Tavsiye

Sayısal veya tarih ve saat değerlerine biçim dizeleri uygulamanıza ve sonuç dizesini görüntülemenize olanak tanıyan bir .NET Windows Forms uygulaması olan Biçimlendirme Yardımcı Programı'nı indirebilirsiniz. Kaynak kodu C# ve Visual Basiciçin kullanılabilir.

Uyarı

Bu makaledeki C# örneklerinden bazıları Try.NET satır içi kod çalıştırıcısında ve oyun alanında çalıştırılır. Etkileşimli bir pencerede örnek çalıştırmak için Çalıştır düğmesini seçin. Kodu yürüttükten sonra, kodu değiştirebilir ve değiştirilen kodu yeniden çalıştır'ı seçerek çalıştırabilirsiniz. Değiştirilen kod etkileşimli pencerede çalışır veya derleme başarısız olursa, etkileşimli pencerede tüm C# derleyicisi hata iletileri görüntülenir.

Try.NET satır içi kod çalıştırıcısının ve oyun alanının yerel saat dilimi Eşgüdümlü Evrensel Saat veya UTC'dir. Bu, DateTime, DateTimeOffsetve TimeZoneInfo türlerini ve üyelerini gösteren örneklerin davranışını ve çıkışını etkileyebilir.

Biçim tanımlayıcıları tablosu

Aşağıdaki tabloda standart tarih ve saat biçimi tanımlayıcıları açıklanmaktadır. Aksi belirtilmediği sürece, belirli bir standart tarih ve saat biçimi tanımlayıcısı, DateTime veya DateTimeOffset değerle kullanıldığından bağımsız olarak aynı dize gösterimini oluşturur. Standart tarih ve saat biçim dizelerini kullanma hakkında ek bilgi için bkz. Denetim Masası Ayarları ve DateTimeFormatInfo Özellikleri.

Biçim tanımlayıcısı	Açıklama	Örnekler
"d"	Kısa Tarih Modeli Daha fazla bilgi:Kısa tarih ("d") biçim belirtici.	2009-06-15T13:45:30 -> 15/6/2009 (tr-TR) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	Uzun tarih deseni. Daha fazla bilgi:Uzun tarih ("D") biçim belirtici.	2009-06-15T13:45:30 -> Pazartesi, 15 Haziran 2009 (tr-TR) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
f	Tam tarih veya saat deseni (süre). Daha fazla bilgi: Tam tarih kısa saati ("f") biçim tanımlayıcısı.	2009-06-15T13:45:30 -> Pazartesi, 15 Haziran 2009 13:45 (EN-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F"	Tam tarih veya saat deseni (uzun süre). Daha fazla bilgi: Tam tarih uzun saati ("F") biçim tanımlayıcısı.	2009-06-15T13:45:30 -> 15 Haziran 2009 Pazartesi 13:45:30 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g"	Genel tarih veya saat deseni (süre). Daha fazla bilgi: Genel tarih kısa saati ("g") biçim tanımlayıcısı.	2009-06-15T13:45:30 -> 15/6/2009 13:45 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	Genel tarih veya saat deseni (uzun süre). Daha fazla bilgi: Genel tarih uzun saati ("G") biçim tanımlayıcısı.	2009-06-15T13:45:30 -> 15/6/2009 13:45:30 (EN-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m"	Ay/gün deseni. Daha fazla bilgi: Ay ("M", "m") biçim tanımlayıcısı.	2009-06-15T13:45:30 -> 15 Haziran (tr-TR) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o"	gidiş dönüş tarih/saat deseni. Daha fazla bilgi: Gidiş dönüş ("O", "o") biçim tanımlayıcısı.	DateTime değerleri: 2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:00 2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z 2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000 DateTimeOffset değerleri: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
"R", "r"	Desen: RFC1123 Daha fazla bilgi: RFC1123 ("R", "r") biçim tanımlayıcısı.	DateTimeOffset girişi: 2009-06-15T13:45:30 -> Mon, 15 Haziran 2009 20:45:30 GMT DateTime girişi: 2009-06-15T13:45:30 -> Mon, 15 Haziran 2009 13:45:30 GMT
"s"	Sıralanabilir tarih veya saat deseni. Daha fazla bilgi: Sıralanabilir ("s") biçim tanımlayıcısı.	2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30 2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
"t"	Kısa bir süre deseni. Daha fazla bilgi: Kısa süre ("t") biçim tanımlayıcısı.	2009-06-15T13:45:30 -> 13:45 (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	Uzun süre deseni. Daha fazla bilgi: Uzun süre ("T") biçim tanımlayıcısı.	2009-06-15T13:45:30 -> 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 13:45:30 (sa-hr) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u"	Evrensel sıralanabilir tarih/saat deseni. Daha fazla bilgi: Evrensel sıralanabilir ("u") biçim tanımlayıcısı.	DateTime değeriyle: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z DateTimeOffset değeriyle: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Evrensel tam tarih/saat düzeni. Daha fazla bilgi: Evrensel tam ("U") biçim belirtici.	2009-06-15T13:45:30 -> 15 Haziran 2009 Pazartesi 20:45:30 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 20:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
"Y", "y"	Yıl ay deseni. Daha fazla bilgi: Yıl ayı ("Y") biçim belirticisi.	2009-06-15T13:45:30 -> Haziran 2009 (tr-TR) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Başka bir tek karakter	Bilinmeyen tanımlayıcı.	bir çalışma zamanı FormatExceptionoluşturur.

Standart biçim dizeleri nasıl çalışır?

Bir biçimlendirme işleminde, standart biçim dizesi aslında bir özel biçim dizesi için diğer addır. Bir özel biçim dizesine başvururken diğer ad kullanmanın yararı, diğer ad değişmez iken özel biçim dizesinin kendisinin değişebilmesidir. Bu, tarih ve saat değerleri genellikle kültüre göre değiştiği için önemlidir. Örneğin, "d" standart biçim dizesi bir tarih ve saat değerinin kısa tarih deseni kullanılarak görüntüleneceğini belirtir. Sabit kültür için bu desen "MM/dd/yyyy" şeklindedir. fr-FR kültürü için "dd/MM/yyyy" şeklindedir. ja-JP kültürü için "yyyy/MM/dd" şeklindedir.

Eğer bir biçimlendirme işleminde standart format dizesi belirli bir kültürün özel biçim dizesiyle eşleniyorsa, uygulamanız özel biçim dizeleri aşağıdaki şekillerden birinde kullanılan belirli kültürü tanımlayabilir:

Varsayılan (veya geçerli( kültürü kullanabilirsiniz. Aşağıdaki örnek geçerli kültürün kısa tarih biçimini kullanarak bir tarih görüntüler. Bu durumda geçerli kültür en-US değeridir.

// Display using current (en-us) culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
Console.WriteLine(thisDate.ToString("d"));           // Displays 3/15/2008

' Display using current (en-us) culture's short date format
Dim thisDate As Date = #03/15/2008#
Console.WriteLine(thisDate.ToString("d"))     ' Displays 3/15/2008

Biçimlendirmesi kullanılacak kültürü temsil eden bir CultureInfo nesnesini IFormatProvider parametresi olan bir yönteme geçirebilirsiniz. Aşağıdaki örnek pt-BR kültürünün kısa tarih biçimini kullanarak bir tarih görüntüler.

// Display using pt-BR culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
CultureInfo culture = new CultureInfo("pt-BR");
Console.WriteLine(thisDate.ToString("d", culture));  // Displays 15/3/2008

' Display using pt-BR culture's short date format
Dim thisDate As Date = #03/15/2008#
Dim culture As New CultureInfo("pt-BR")
Console.WriteLine(thisDate.ToString("d", culture))   ' Displays 15/3/2008

IFormatProvider parametresi olan bir yönteme biçimlendirme bilgileri sağlayan bir DateTimeFormatInfo nesnesi geçirebilirsiniz. Aşağıdaki örnekte, hr-HR kültürü için bir DateTimeFormatInfo nesnesinden kısa tarih biçimini kullanan bir tarih görüntülenir.

// Display using date format information from hr-HR culture
DateTime thisDate = new DateTime(2008, 3, 15);
DateTimeFormatInfo fmt = (new CultureInfo("hr-HR")).DateTimeFormat;
Console.WriteLine(thisDate.ToString("d", fmt));      // Displays 15.3.2008

' Display using date format information from hr-HR culture
Dim thisDate As Date = #03/15/2008#
Dim fmt As DateTimeFormatInfo = (New CultureInfo("hr-HR")).DateTimeFormat
Console.WriteLine(thisDate.ToString("d", fmt))   ' Displays 15.3.2008

Uyarı

Tarih ve saat değerlerini biçimlendirmek için kullanılan desenleri veya dizeleri özelleştirme hakkında bilgi için NumberFormatInfo sınıfı konusuna bakın.

Bazı durumlarda, standart biçim dizesi sabit olan daha uzun bir özel biçim dizesi için uygun bir kısaltma görevi görür. Dört standart biçim dizesi bu kategoriye girer: "O" (veya "o"), "R" (veya "r"), "s" ve "u". Bu dizeler sabit kültür tarafından tanımlanan özel biçim dizelerine karşılık gelir. Kültürler arası aynı olan tarih ve saat değerlerinin dize temsillerini oluştururlar. Aşağıdaki tablo bu dört standart tarih ve saat biçim dizesi hakkında bilgi verir.

Standart biçim dizeleri	DateTimeFormatInfo.InvariantInfo özelliği tarafından tanımlanır	Özel biçim dizesi
"O" veya "o"	Hiç kimse	yyyy'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffK
"R" ya da "r"	RFC1123Pattern	ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s"	SortableDateTimePattern	yyyy'-'MM'-'dd'T'HH':'mm':'ss
"u"	UniversalSortableDateTimePattern	yyyy'-'MM'-'dd HH':'mm':'ss'Z'

Standart biçim dizeleri, ayrıştırma işleminin başarılı olması için belirli bir desene tam olarak uyması için bir giriş dizesi gerektiren DateTime.ParseExact veya DateTimeOffset.ParseExact yöntemleriyle ayrıştırma işlemlerinde de kullanılabilir. Birçok standart biçim dizesi birden çok özel biçim dizesiyle eşlenir, bu nedenle tarih ve saat değeri çeşitli biçimlerde temsil edilebilir ve ayrıştırma işlemi yine başarılı olur. DateTimeFormatInfo.GetAllDateTimePatterns(Char) yöntemini çağırarak standart biçim dizesine karşılık gelen özel biçim dizesini veya dizeleri belirleyebilirsiniz. Aşağıdaki örnek, "d" (kısa tarih deseni) standart biçim dizesine eşleyen özel biçim dizelerini görüntüler.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("'d' standard format string:");
      foreach (var customString in DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns('d'))
          Console.WriteLine($"   {customString}");
   }
}
// The example displays the following output:
//       'd' standard format string:
//          M/d/yyyy
//          M/d/yy
//          MM/dd/yy
//          MM/dd/yyyy
//          yy/MM/dd
//          yyyy-MM-dd
//          dd-MMM-yy

Imports System.Globalization

Module Example
    Public Sub Main()
        Console.WriteLine("'d' standard format string:")
        For Each customString In DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns("d"c)
            Console.WriteLine("   {0}", customString)
        Next
    End Sub
End Module
' The example displays the following output:
'    'd' standard format string:
'       M/d/yyyy
'       M/d/yy
'       MM/dd/yy
'       MM/dd/yyyy
'       yy/MM/dd
'       yyyy-MM-dd
'       dd-MMM-yy

Aşağıdaki bölümlerde, DateTime ve DateTimeOffset değerleri için standart biçim tanımlayıcıları açıklanmaktadır.

Tarih biçimleri

Bu grup aşağıdaki biçimleri içerir:

Kısa tarih ("d") biçim tanımlayıcısı
Uzun tarih ("D") biçim tanımlayıcısı

Kısa tarih ("d") biçim tanımlayıcısı

"d" standart biçim tanımlayıcısı, belirli bir kültürün DateTimeFormatInfo.ShortDatePattern özelliği tarafından tanımlanan özel bir tarih ve saat biçimi dizesini temsil eder. Örneğin, sabit kültürün ShortDatePattern özelliği tarafından döndürülen özel biçim dizesi "AA/gg/yyyy"dir.

Aşağıdaki tabloda, döndürülen dizenin biçimlendirmesini denetleyen DateTimeFormatInfo nesne özellikleri listelenir.

Mülkiyet	Açıklama
ShortDatePattern	Sonuç dizesinin genel biçimini tanımlar.
DateSeparator	Bir tarihin yıl, ay ve gün bileşenlerini ayıran dizeyi tanımlar.

Aşağıdaki örnekte bir tarih ve saat değeri görüntülemek için "d" biçim tanımlayıcısı kullanılır.

DateTime date1 = new DateTime(2008,4, 10);
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays 4/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-NZ")));
// Displays 10/04/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("de-DE")));
// Displays 10.04.2008

Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays 4/10/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-NZ")))
' Displays 10/04/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("de-DE")))
' Displays 10.04.2008

Mülkiyet	Açıklama
LongDatePattern	Sonuç dizesinin genel biçimini tanımlar.
DayNames	Sonuç dizesinde görüntülenebilen yerelleştirilmiş gün adlarını tanımlar.
MonthNames	Sonuç dizesinde görüntülenebilen yerelleştirilmiş ay adlarını tanımlar.

Mülkiyet	Açıklama
LongDatePattern	Sonuç dizesinin tarih bileşeninin biçimini tanımlar.
ShortTimePattern	Sonuç dizesinin zaman bileşeninin biçimini tanımlar.
DayNames	Sonuç dizesinde görüntülenebilen yerelleştirilmiş gün adlarını tanımlar.
MonthNames	Sonuç dizesinde görüntülenebilen yerelleştirilmiş ay adlarını tanımlar.
TimeSeparator	Bir saatin saat, dakika ve ikinci bileşenlerini ayıran dizeyi tanımlar.
AMDesignator	12 saatlik bir saatte gece yarısından öğlene kadar olan saatleri belirten dizeyi tanımlar.
PMDesignator	12 saatlik bir saatte öğlenden gece yarısına kadar olan saatleri belirten dizeyi tanımlar.

Mülkiyet	Açıklama
FullDateTimePattern	Sonuç dizesinin genel biçimini tanımlar.
DayNames	Sonuç dizesinde görüntülenebilen yerelleştirilmiş gün adlarını tanımlar.
MonthNames	Sonuç dizesinde görüntülenebilen yerelleştirilmiş ay adlarını tanımlar.
TimeSeparator	Bir saatin saat, dakika ve ikinci bileşenlerini ayıran dizeyi tanımlar.
AMDesignator	12 saatlik bir saatte gece yarısından öğlene kadar olan saatleri belirten dizeyi tanımlar.
PMDesignator	12 saatlik bir saatte öğlenden gece yarısına kadar olan saatleri belirten dizeyi tanımlar.

Mülkiyet	Açıklama
ShortDatePattern	Sonuç dizesinin tarih bileşeninin biçimini tanımlar.
LongTimePattern	Sonuç dizesinin zaman bileşeninin biçimini tanımlar.
DateSeparator	Bir tarihin yıl, ay ve gün bileşenlerini ayıran dizeyi tanımlar.
TimeSeparator	Bir saatin saat, dakika ve ikinci bileşenlerini ayıran dizeyi tanımlar.
AMDesignator	12 saatlik bir saatte gece yarısından öğlene kadar olan saatleri belirten dizeyi tanımlar.
PMDesignator	12 saatlik bir saatte öğlenden gece yarısına kadar olan saatleri belirten dizeyi tanımlar.

Mülkiyet	Açıklama
RFC1123Pattern	Sonuç dizesinin biçimini tanımlar.
AbbreviatedDayNames	Sonuç dizesinde görüntülenebilen kısaltılmış gün adlarını tanımlar.
AbbreviatedMonthNames	Sonuç dizesinde görünebilen kısaltılmış ay adlarını tanımlar.

Mülkiyet	Açıklama
MonthDayPattern	Sonuç dizesinin genel biçimini tanımlar.
MonthNames	Sonuç dizesinde görüntülenebilen yerelleştirilmiş ay adlarını tanımlar.

Mülkiyet	Açıklama
YearMonthPattern	Sonuç dizesinin genel biçimini tanımlar.
MonthNames	Sonuç dizesinde görüntülenebilen yerelleştirilmiş ay adlarını tanımlar.

Aracılığıyla paylaş

Standart tarih ve saat biçimi dizeleri

Biçim tanımlayıcıları tablosu

Standart biçim dizeleri nasıl çalışır?

Tarih biçimleri

Kısa tarih ("d") biçim tanımlayıcısı

Uzun tarih ("D") biçim tanımlayıcısı

Tarih ve saat biçimleri

Tam tarih kısa saati ("f") biçim tanımlayıcısı

Tam tarih uzun saati ("F") biçim tanımlayıcısı

Genel tarih kısa saati ("g") biçim tanımlayıcısı

Genel tarih uzun saati ("G") biçim tanımlayıcısı

Gidiş dönüş ("O", "o") biçim tanımlayıcısı

RFC1123 ("R", "r") biçim tanımlayıcısı

Sıralanabilir ("s") biçim tanımlayıcısı

Evrensel sıralanabilir ("u") biçim tanımlayıcısı

Evrensel tam ("U") biçim tanımlayıcısı

Saat biçimleri

Kısa süre ("t") biçim tanımlayıcısı

Uzun süre ("T") biçim tanımlayıcısı

Kısmi tarih biçimleri

Ay ("M", "m") biçim tanımlayıcısı

Yıl ayı ("Y", "y") biçim tanımlayıcısı

Denetim Masası ayarları

DateTimeFormatInfo özellikleri

Ayrıca bkz.

Geri Bildirim

Ek kaynaklar