Standart tarih ve saat biçim dizeleri

Makale
04/08/2023

Standart tarih ve saat biçim dizesi, bir veya değerinin metin gösterimini DateTime tanımlamak için biçim belirtici olarak tek bir DateTimeOffset 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 bir biçim dizesi iki şekilde kullanılabilir:

Bir biçimlendirme işleminin sonucunda ortaya çıkan dizeyi tanımlamak için.
Ayrıştırma işlemiyle veya DateTimeOffset değerine dönüştürülebilecek bir DateTime tarih ve saat değerinin metin gösterimini tanımlamak için.

İpucu

Biçimlendirme dizelerini sayısal veya tarih ve saat değerlerine 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 Basic için kullanılabilir.

Not

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 pencerede bir örnek çalıştırmak için Çalıştır düğmesini seçin. Kodu yürütürken yeniden Çalıştır'ı seçerek kodu değiştirebilir ve değiştirilmiş kodu ç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, , DateTimeOffsetve türlerini ve üyelerini gösteren örneklerin DateTimedavranışını ve TimeZoneInfo çı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ı, bir veya DateTimeOffset bir değerle DateTime 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 ayarlar ve DateTimeFormatInfo Özellikleri Denetim Masası bakın.

Biçim belirteci	Açıklama	Örnekler
"d"	Kısa Tarih Modeli Daha fazla bilgi: Kısa tarih ("d") biçim tanımlayıcısı.	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 tanımlayıcısı.	2009-06-15T13:45:30 -> 15 Haziran 2009 Pazartesi (en-US) 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 -> 15 Haziran 2009 Pazartesi 13:45 (tr-TR) 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 saat ("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 saat ("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ğer: 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ğer: 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 input: 2009-06-15T13:45:30 -> Mon, 15 Haziran 2009 20:45:30 GMT DateTime input: 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 PM (tr-TR) 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 -> 13:45:30 (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-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ı.	Değerle DateTime : 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z Değerle DateTimeOffset : 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Evrensel tam tarih/saat deseni. Daha fazla bilgi: Evrensel tam ("U") biçim tanımlayıcısı.	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 tanımlayıcısı.	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 olan kültürü temsil eden bir CultureInfo nesneyi parametresi olan IFormatProvider 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

Biçimlendirme bilgilerini sağlayan bir DateTimeFormatInfo nesneyi parametresi olan IFormatProvider bir yönteme geçirebilirsiniz. Aşağıdaki örnekte hr-HR kültürü için bir nesneden kısa tarih biçimini kullanan bir DateTimeFormatInfo 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

Not

Tarih ve saat değerlerini biçimlendirmede kullanılan desenleri veya dizeleri özelleştirme hakkında bilgi için sınıf konusuna NumberFormatInfo 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ımı	Özel biçim dizesi
"O" veya "o"	Hiçbiri	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 DateTime.ParseExact başarılı olması için belirli bir desene tam olarak uyması için bir giriş dizesi gerektiren veya DateTimeOffset.ParseExact yöntemleriyle ayrıştırma işlemlerinde de kullanılabilir. Birçok standart biçim dizesi birden çok özel biçim dizesine eşlenir, yani bir tarih ve saat değeri çeşitli biçimlerde temsil edilebilir ve ayrıştırma işlemi yine de başarılı olur. yöntemini çağırarak DateTimeFormatInfo.GetAllDateTimePatterns(Char) özel biçim dizesini veya standart biçim dizesine karşılık gelen dizeleri belirleyebilirsiniz. Aşağıdaki örnek "d" (kısa tarih deseni) standart biçim dizesiyle eşlenen ö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("   {0}", 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 ve DateTimeOffset değerleri için DateTime 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çim dizesini temsil eder. Örneğin, sabit kültürün özelliği tarafından ShortDatePattern döndürülen özel biçim dizesi "AA/gg/yyyy"dir.

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

Özellik	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 örnek bir tarih ve saat değerini görüntülemek için "d" biçim tanımlayıcısını kullanı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

Özellik	Açıklama
LongDatePattern	Sonuç dizesinin genel biçimini tanımlar.
DayNames	Sonuç dizesinde görünebilen yerelleştirilmiş gün adlarını tanımlar.
MonthNames	Sonuç dizesinde görünebilen yerelleştirilmiş ay adlarını tanımlar.

Özellik	Açıklama
LongDatePattern	Sonuç dizesinin tarih bileşeninin biçimini tanımlar.
ShortTimePattern	Sonuç dizesinin saat bileşeninin biçimini tanımlar.
DayNames	Sonuç dizesinde görünebilen yerelleştirilmiş gün adlarını tanımlar.
MonthNames	Sonuç dizesinde görünebilen yerelleştirilmiş ay adlarını tanımlar.
TimeSeparator	Bir saatin saat, dakika ve saniye bileşenlerini ayıran dizeyi tanımlar.
AMDesignator	12 saatlik bir saatte gece yarısı ile öğleden önce arasındaki saatleri belirten dizeyi tanımlar.
PMDesignator	12 saatlik bir saatte öğleden önce ile gece yarısı arasındaki saatleri belirten dizeyi tanımlar.

Özellik	Açıklama
FullDateTimePattern	Sonuç dizesinin genel biçimini tanımlar.
DayNames	Sonuç dizesinde görünebilen yerelleştirilmiş gün adlarını tanımlar.
MonthNames	Sonuç dizesinde görünebilen yerelleştirilmiş ay adlarını tanımlar.
TimeSeparator	Bir saatin saat, dakika ve saniye bileşenlerini ayıran dizeyi tanımlar.
AMDesignator	12 saatlik bir saatte gece yarısı ile öğleden önce arasındaki saatleri belirten dizeyi tanımlar.
PMDesignator	12 saatlik bir saatte öğleden önce ile gece yarısı arasındaki saatleri belirten dizeyi tanımlar.

Özellik	Açıklama
ShortDatePattern	Sonuç dizesinin tarih bileşeninin biçimini tanımlar.
LongTimePattern	Sonuç dizesinin saat 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 saniye bileşenlerini ayıran dizeyi tanımlar.
AMDesignator	12 saatlik bir saatte gece yarısı ile öğleden önce arasındaki saatleri belirten dizeyi tanımlar.
PMDesignator	12 saatlik bir saatte öğleden önce ile gece yarısı arasındaki saatleri belirten dizeyi tanımlar.

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

Özellik	Açıklama
MonthDayPattern	Sonuç dizesinin genel biçimini tanımlar.
MonthNames	Sonuç dizesinde görünebilen yerelleştirilmiş ay adlarını tanımlar.

Özellik	Açıklama
YearMonthPattern	Sonuç dizesinin genel biçimini tanımlar.
MonthNames	Sonuç dizesinde görünebilen yerelleştirilmiş ay adlarını tanımlar.

Standart tarih ve saat biçim 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 saat ("F") biçim tanımlayıcısı

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

Genel tarih uzun saat ("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ı

Zaman biçimleri

Kısa süre ("t") biçim belirticisi

Uzun süre ("T") biçim belirticisi

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