Szabványos dátum- és időformátum-sztringek

Cikk
04/08/2023

A szabványos dátum- és időformátum-sztringek egyetlen karaktert használnak formátumkijelölőként egy vagy egy DateTimeOffset érték szöveges ábrázolásának DateTime meghatározásához. Minden olyan dátum- és időformátum-sztring, amely egynél több karaktert tartalmaz, beleértve a szóközt is, egyéni dátum- és időformátum-sztringként lesz értelmezve. A szabványos vagy egyéni formátumsztringek kétféleképpen használhatók:

A formázási műveletből származó sztring definiálása.
Egy dátum- és időérték szöveges ábrázolásának definiálása, amely egy elemzési művelettel átalakítható vagy DateTimeOffset értékkéDateTime.

Tipp

Letöltheti a Formatting Segédprogramot, egy .NET Windows Forms alkalmazást, amellyel formázó sztringeket alkalmazhat numerikus vagy dátum- és időértékekre, és megjelenítheti az eredménysztringet. A forráskód c # és Visual Basic nyelven érhető el.

Megjegyzés

A cikkben szereplő C#-példák némelyike a Try.NET beágyazott kódfuttatóban és játszótéren fut. Kattintson a Futtatás gombra egy példa interaktív ablakban való futtatásához. Miután végrehajtotta a kódot, módosíthatja és futtathatja a módosított kódot a Futtatás újra lehetőséget választva. A módosított kód vagy az interaktív ablakban fut, vagy ha a fordítás sikertelen, az interaktív ablakban megjelenik az összes C#-fordító hibaüzenet.

A Try.NET beágyazott kódfuttató és -játszótér helyi időzónája az Egyezményes világidő vagy UTC. Ez hatással lehet a viselkedésre és a példák kimenetére, amelyek bemutatják a , DateTimeOffseta és a DateTimetípusokat és TimeZoneInfo azok tagjait.

Formátumkijelölők táblázata

Az alábbi táblázat a szabványos dátum- és időformátum-meghatározókat ismerteti. Ha másként nem jelezzük, egy adott szabványos dátum- és időformátum-meghatározó azonos sztringreprezentációt hoz létre, függetlenül attól, hogy egy vagy egy DateTime DateTimeOffset értékkel használja-e. A szabványos dátum- és időformátum-sztringek használatáról további információt a Vezérlőpult Beállítások és a DateTimeFormatInfo tulajdonságai című témakörben talál.

Formátumkijelölő	Leírás	Példák
"d"	Rövid dátumminta. További információ:A rövid dátum ("d") formátumjelölője.	2009-06-15T13:45:30 -> 6/15/2009 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	Hosszú dátumminta. További információ:A hosszú dátum ("D") formátumjelölője.	2009-06-15T13:45:30 -> 2009. június 15., hétfő (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f"	Teljes dátum/idő minta (rövid idő). További információ: A teljes dátum rövid ideje ("f") formátumkijelölő.	2009-06-15T13:45:30 -> 2009. június 15., hétfő 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"	Teljes dátum/idő minta (hosszú idő). További információ: A teljes dátum hosszú ideje ("F") formátumkijelölő.	2009-06-15T13:45:30 -> 2009. június 15., hétfő 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"	Általános dátum/idő minta (rövid idő). További információ: Az általános dátum rövid idő ("g") formátumjelölője.	2009-06-15T13:45:30 -> 2009.06.15. 13:45 (en-US) 2009-06-15T13:45:30 -> 2009.06.15. 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	Általános dátum/idő minta (hosszú idő). További információ: Az általános dátum hosszú ideje ("G") formátumkijelölő.	2009-06-15T13:45:30 -> 2009.06.15. 1:45:30 (en-US) 2009-06-15T13:45:30 -> 2009.06.15. 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m"	Hónap/nap minta. További információ: A hónap ("M", "m") formátumjelölője.	2009-06-15T13:45:30 -> Június 15 (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o"	az oda-vissza út dátum-/időmintája. További információ: Az oda-vissza ("O", "o") formátumkijelölő.	DateTime Értékek: 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.00000000Z 2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000 DateTimeOffset Értékek: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.00000000-07:00
"R", "r"	RFC1123 minta. További információ: Az RFC1123 ("R", "r") formátumkijelölő.	DateTimeOffset bemenet: 2009-06-15T13:45:30 -> H, 15 Jun 2009 20:45:30 GMT DateTime bemenet: 2009-06-15T13:45:30 -> H, 15 Jun 2009 13:45:30 GMT
"s"	Rendezhető dátum/idő minta. További információ: A rendezhető ("s") formátumkijelölő.	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"	Rövid idő minta. További információ: A rövid idő ("t") formátumkijelölő.	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"	Hosszú idő minta. További információ: A hosszú idő ("T") formátumkijelölő.	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"	Univerzális rendezhető dátum/idő minta. További információ: Az univerzális rendezhető ("u") formátumkijelölő.	Érték: DateTime 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z Érték: DateTimeOffset 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Univerzális teljes dátum/idő minta. További információ: Az univerzális teljes ("U") formátumkijelölő.	2009-06-15T13:45:30 –> 2009. június 15., hétfő 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"	Év hónap mintája. További információ: Az év hónapja ("Y") formátumválasztó.	2009-06-15T13:45:30 –> 2009. június (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Bármely más önálló karakter	Ismeretlen kijelölő.	Futásidőt FormatExceptionad.

A szabványos formázási sztringek működése

A formázási műveletekben a szabványos formázási sztringek egyszerűen egy egyéni formázási sztring aliasai. Az alias egyéni formátumsztringre való hivatkozásának előnye, hogy bár az alias invariáns marad, maga az egyéni formátumsztring változhat. Ez azért fontos, mert a dátum- és időértékek sztringreprezentációi általában kultúránként változnak. A "d" standard formátumú sztring például azt jelzi, hogy egy dátum- és időértéket rövid dátummintával kell megjeleníteni. Az invariáns kultúra esetében ez a minta "MM/dd/yyyy". Az fr-FR kultúra esetében ez a "dd/MM/yyyy". A ja-JP kultúra esetében ez a "yyyy/MM/dd".

Ha egy formázási műveletben egy szabványos formázási sztring egy adott kulturális környezet egyéni formátumsztringjére van leképezve, az alkalmazás az alábbi módokon definiálhatja azt a kulturális környezetet, amelynek egyéni formátumsztringjei a következők:

Használhatja az alapértelmezett (vagy aktuális) kultúrát. Az alábbi példa egy dátumot jelenít meg az aktuális kultúra rövid dátumformátumával. Ebben az esetben a jelenlegi kultúra az EN-US.

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

Átadhat egy CultureInfo olyan objektumot, amely azt a kultúrát képviseli, amelynek formázását paraméterrel IFormatProvider rendelkező metódushoz kell használni. Az alábbi példa egy dátumot jelenít meg a pt-BR-kultúra rövid dátumformátumával.

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

Olyan objektumot adhat át DateTimeFormatInfo , amely formázási információkat biztosít egy paraméterrel IFormatProvider rendelkező metódusnak. Az alábbi példában egy olyan dátum látható, amely a hr-HR-kultúra objektumának DateTimeFormatInfo rövid dátumformátumát használja.

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

Megjegyzés

A dátum- és időértékek formázásához használt minták vagy sztringek testreszabásáról az osztály témakörében NumberFormatInfo olvashat.

Bizonyos esetekben a standard formátumú sztring kényelmes rövidítésként szolgál egy hosszabb egyéni formátumsztringhez, amely invariáns. Négy szabványos formátumsztring tartozik ebbe a kategóriába: "O" (vagy "o"), "R" (vagy "r"), "s" és "u". Ezek a sztringek az invariáns kultúra által meghatározott egyéni formátumsztringeknek felelnek meg. Olyan dátum- és időértékek sztringreprezentációit állítják elő, amelyek a kultúrák között azonosak. Az alábbi táblázat a négy szabványos dátum- és időformátum-sztringről nyújt információt.

Standard formátumú sztring	A DateTimeFormatInfo.InvariantInfo tulajdonság határozza meg	Egyéni formázási sztring
"O" vagy "o"	None	yyyy'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffK
"R" vagy "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'

A standard formátumú sztringek a vagy DateTimeOffset.ParseExact metódusokkal DateTime.ParseExact végzett elemzési műveletekhez is használhatók, amelyekhez egy bemeneti sztringnek pontosan meg kell felelnie az elemzési művelet sikerességéhez szükséges adott mintának. Számos szabványos formátumsztring több egyéni formátumsztringre van leképezve, így egy dátum- és időérték többféle formátumban is megjeleníthető, és az elemzési művelet továbbra is sikeres lesz. A metódus meghívásával meghatározhatja a szabványos formátumsztringnek megfelelő egyéni formázási DateTimeFormatInfo.GetAllDateTimePatterns(Char) sztringeket vagy sztringeket. Az alábbi példa azokat az egyéni formázási sztringeket jeleníti meg, amelyek a "d" (rövid dátumminta) standard formátumsztringre képeznek le.

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

Az alábbi szakaszok a és DateTimeOffset az értékek szabványos formátumkijelölőit ismertetikDateTime.

Dátumformátumok

Ez a csoport a következő formátumokat tartalmazza:

A rövid dátum ("d") formátumkijelölője
A hosszú dátum ("D") formátumkijelölője

A rövid dátum ("d") formátumkijelölője

A "d" standard formátumkijelölő egy egyéni dátum- és időformátum-sztringet jelöl, amelyet egy adott kulturális környezet tulajdonsága DateTimeFormatInfo.ShortDatePattern határoz meg. Az invariáns kultúra tulajdonsága által ShortDatePattern visszaadott egyéni formátumsztring például "MM/dd/yyyy".

Az alábbi táblázat felsorolja azokat az DateTimeFormatInfo objektumtulajdonságokat, amelyek a visszaadott sztring formázását szabályozzák.

Tulajdonság	Leírás
ShortDatePattern	Meghatározza az eredménysztring általános formátumát.
DateSeparator	Meghatározza azt a sztringet, amely egy dátum év, hónap és nap összetevőit választja el egymástól.

Az alábbi példa a "d" formátumkijelölőt használja egy dátum- és időérték megjelenítéséhez.

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

Tulajdonság	Leírás
LongDatePattern	Meghatározza az eredménysztring általános formátumát.
DayNames	Meghatározza az eredménysztringben megjeleníthető honosított napneveket.
MonthNames	Meghatározza az eredménysztringben megjeleníthető honosított hónapneveket.

Tulajdonság	Leírás
LongDatePattern	Meghatározza az eredménysztring dátumösszetevőjének formátumát.
ShortTimePattern	Meghatározza az eredménysztring időösszetevőjének formátumát.
DayNames	Meghatározza az eredménysztringben megjeleníthető honosított napneveket.
MonthNames	Meghatározza az eredménysztringben megjeleníthető honosított hónapneveket.
TimeSeparator	Meghatározza azt a sztringet, amely elválasztja az idő óráját, percét és második összetevőit.
AMDesignator	Meghatározza azt a sztringet, amely éjféltől délig 12 órán belül jelzi az időpontokat.
PMDesignator	Meghatározza azt a sztringet, amely 12 órán belül déltől éjfélig tartó időt jelez.

Tulajdonság	Leírás
FullDateTimePattern	Meghatározza az eredménysztring általános formátumát.
DayNames	Meghatározza az eredménysztringben megjeleníthető honosított napneveket.
MonthNames	Meghatározza az eredménysztringben megjeleníthető honosított hónapneveket.
TimeSeparator	Meghatározza azt a sztringet, amely elválasztja az idő óráját, percét és második összetevőit.
AMDesignator	Meghatározza azt a sztringet, amely éjféltől délig 12 órán belül jelzi az időpontokat.
PMDesignator	Meghatározza azt a sztringet, amely 12 órán belül déltől éjfélig tartó időt jelez.

Tulajdonság	Leírás
ShortDatePattern	Meghatározza az eredménysztring dátumösszetevőjének formátumát.
LongTimePattern	Meghatározza az eredménysztring időösszetevőjének formátumát.
DateSeparator	Meghatározza azt a sztringet, amely egy dátum év, hónap és nap összetevőit választja el egymástól.
TimeSeparator	Meghatározza azt a sztringet, amely elválasztja az idő óráját, percét és második összetevőit.
AMDesignator	Meghatározza azt a sztringet, amely éjféltől délig 12 órán belül jelzi az időpontokat.
PMDesignator	Meghatározza azt a sztringet, amely 12 órán belül déltől éjfélig tartó időt jelez.

Tulajdonság	Leírás
RFC1123Pattern	Meghatározza az eredménysztring formátumát.
AbbreviatedDayNames	Meghatározza az eredménysztringben megjeleníthető rövidített napneveket.
AbbreviatedMonthNames	Meghatározza az eredménysztringben megjeleníthető rövidített hónapneveket.

Tulajdonság	Leírás
MonthDayPattern	Meghatározza az eredménysztring általános formátumát.
MonthNames	Meghatározza az eredménysztringben megjeleníthető honosított hónapneveket.

Tulajdonság	Leírás
YearMonthPattern	Meghatározza az eredménysztring általános formátumát.
MonthNames	Meghatározza az eredménysztringben megjeleníthető honosított hónapneveket.

Szabványos dátum- és időformátum-sztringek

Formátumkijelölők táblázata

A szabványos formázási sztringek működése

Dátumformátumok

A rövid dátum ("d") formátumkijelölője

A hosszú dátum ("D") formátumkijelölője

Dátum- és időformátumok

A teljes dátum rövid ideje ("f") formátumkijelölője

A teljes dátum hosszú ideje ("F") formátumjelölője

Az általános dátum rövid ideje ("g") formátumjelölője

Az általános dátum hosszú ideje ("G") formátumjelölője

Az oda-vissza ("O", "o") formátumkijelölő

Az RFC1123 ("R", "r") formátumkijelölő

A rendezhető ("s") formátumkijelölő

Az univerzális rendezhető ("u") formátumkijelölő

Az univerzális teljes ("U") formátumkijelölő

Időformátumok

A rövid idő ("t") formátumkijelölője

A hosszú idő ("T") formátumkijelölője

Részleges dátumformátumok

A hónap ("M", "m") formátumkijelölője

Az év hónapja ("Y", "y") formátumkijelölője

Vezérlőpult beállítások

DateTimeFormatInfo tulajdonságai

Lásd még

Visszajelzés

További források