Standard dátum- és időformátum-sztringek

A szabványos dátum- és időformátum-sztringek egyetlen karaktert használnak formátumkijelölőként egy , DateTime, DateTimeOffsetvagy DateOnly érték szöveges ábrázolásának TimeOnlymeghatá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. Egy szabványos vagy egyéni formátumsztring kétféleképpen használható:

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

Tipp

Letöltheti a Formázás segédprogram, egy .NET Windows Forms alkalmazás, amely lehetővé teszi a formázási sztringek numerikus vagy dátum- és időértékekre való alkalmazását és az eredménysztring megjelenítését. A forráskód C# és Visual Basicérhető el.

Formátumjelö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 jelenik meg, egy adott szabványos dátum- és időformátum-meghatározó azonos sztring-ábrázolásokat hoz létre, függetlenül attól, hogy DateTime vagy DateTimeOffset értékkel használják. Nem minden formátumjelölő használható az értékekhez és DateOnly az TimeOnly értékekhez. További információt a DateOnly és a TimeOnly formázással kapcsolatban talál. Arról, hogy a Windows és az aktuális DateTimeFormatInfo objektum területi beállításai hogyan befolyásolhatják a dátum- és időformázást, olvassa el a Vezérlőpult beállításai és a DateTimeFormatInfo tulajdonságai című témakört.

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ő.	2009-06-15T13:45:30 -> 2009.06.15. (en-US) 2009-06-15T13:45:30 -> 2009.06.15. (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP) DateOnly (2009-06-15) -> 6/15/2009 (en-US)
"D"	Hosszú dátumminta. További információ:A hosszú dátum ("D") formátumkijelölő.	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 -> hétfő, 15. Juni 2009 (de-DE)
f	Teljes dátum/idő minta (rövid idő). További információ: A teljes dátumú rövid idő ("f") formátumválasztó.	2009-06-15T13:45:30 -> 2009. június 15., hétfő 13:45 (en-US) 2009-06-15T13:45:30 -> 2009. június 15. 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 ideje ("g") formátumválasztó.	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. 13: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átumválasztó.	2009-06-15T13:45:30 -> Június 15 (en-US) 2009-06-15T13:45:30 -> 15. Június (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o"	utazási dátum/idő minta. További információ: Az oda-vissza ("O", "o") formátumválasztó.	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.0000000Z 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.0000000-07:00 DateOnly értékek: 2009-06-15 --> 2009-06-15 TimeOnly értékek: 13:45:30 --> 13:45:30.0000000
"R", "r"	RFC1123 mintát. További információ: A RFC1123 ("R", "r") formátumkijelölő.	DateTimeOffset bemenet: 2009-06-15T13:45:30 -> H, 2009. jún. 15. 20:45:30 GMT DateTime bemenet: 2009-06-15T13:45:30 -> H, 2009. jún. 15. 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átumválasztó.	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) TimeOnly (13:45:30) -> 13:45 (en-US)
"T"	Hosszú idő minta. További információ: A hosszú idő ("T") formátumválasztó.	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) TimeOnly (13:45:30) -> 13:45:30 (en-US)
"u"	Univerzális rendezhető dátum/idő minta. További információ: Az univerzális rendezhető ("u") formátumkijelölő.	DateTime értékkel: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z DateTimeOffset értékkel: 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 -> június 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Bármely más egyetlen karakter	Ismeretlen meghatározó.	Egy futtatókörnyezetet FormatExceptiondob .

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 aliasok egyéni formátumsztringekre való hivatkozásának előnye, hogy bár az alias invariáns marad, maga az egyéni formázási sztring változhat. Ez azért fontos, mert a dátum- és időértékek sztring-ábrázolása általában kultúra szerint változik. A "d" szabványos formátum sztringje 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/ééééé". Az fr-FR kultúra esetében ez a "dd/MM/yyyyy". A ja-JP kultúra esetében ez "yyyyy/MM/dd".

Ha egy formázási művelet szabványos formátumsztringje egy adott kulturális kultúra egyéni formátumsztringjéhez van rendelve, az alkalmazás az alábbi módokon definiálhatja azt a kulturális környezetet, amelynek egyéni formázási sztringjei vannak használva:

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 objektumot, amely azt a kultúrát jelöli, amelynek formázását egy IFormatProvider paraméterrel 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

Átadhat egy DateTimeFormatInfo objektumot, amely formázási információkat biztosít egy IFormatProvider paraméterrel rendelkező metódusnak. Az alábbi példa egy DateTimeFormatInfo objektum rövid dátumformátumát használó dátumot jelenít meg a hr-HR kultúra számára.

// 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 és sztringek testreszabásáról az NumberFormatInfo osztály témakörében olvashat.

Bizonyos esetekben a standard formátumsztring kényelmes rövidítésként szolgál egy hosszabb, invariáns formátumú egyéni sztringhez. 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. Sztring-ábrázolásokat készítenek a különböző kultúrákban azonos dátum- és időértékekről. Az alábbi táblázat a négy szabványos dátum- és időformátum-sztringről nyújt tájékoztatást.

Standard formátumú sztring	DateTimeFormatInfo.InvariantInfo tulajdonság definiálva	Egyéni formázási sztring
"O" vagy "o"	Egyik sem	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 , , DateTime.ParseExact DateTimeOffset.ParseExactés DateOnly.ParseExact metódusokkal TimeOnly.ParseExactvégzett elemzési műveletekhez is használhatók, amelyekhez egy bemeneti sztringnek pontosan meg kell felelnie az elemzési művelet egy adott mintájának a sikeresség érdekében. Számos szabványos formázási sztring több egyéni formátumsztringre van megfeleltetve, így a dátum- és időértékek különböző formátumokban is megjeleníthetők, és az elemzési művelet továbbra is sikeres lesz. A DateTimeFormatInfo.GetAllDateTimePatterns(Char) metódus meghívásával meghatározhatja a szabványos formátumsztringnek megfelelő egyéni formázási 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($"   {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 következő szakaszok az , , DateTime DateTimeOffsetés DateOnly értékek szabványos formátumjelölőinek TimeOnlyleírását ismertetik.

Dátumformátumok

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

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

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

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

Az alábbi táblázat felsorolja a visszaadott sztring formázását vezérlő DateTimeFormatInfo objektumtulajdonságokat.

Ingatlan	Leírás
ShortDatePattern	Az eredménysztring általános formátumát határozza meg.
DateSeparator	Meghatározza a dátum év, hónap és nap összetevőit elválasztó sztringet.

Az alábbi példa a "d" formátumjelö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

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

Ingatlan	Leírás
LongDatePattern	Az eredménysztring dátumösszetevőjének formátumát határozza meg.
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ás időben jelzi az időpontokat.
PMDesignator	Meghatározza azt a sztringet, amely a 12 órás órákban déltől éjfélig tartó időt jelzi.

Ingatlan	Leírás
FullDateTimePattern	Az eredménysztring általános formátumát határozza meg.
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ás időben jelzi az időpontokat.
PMDesignator	Meghatározza azt a sztringet, amely a 12 órás órákban déltől éjfélig tartó időt jelzi.

Ingatlan	Leírás
ShortDatePattern	Az eredménysztring dátumösszetevőjének formátumát határozza meg.
LongTimePattern	Meghatározza az eredménysztring időösszetevőjének formátumát.
DateSeparator	Meghatározza a dátum év, hónap és nap összetevőit elválasztó sztringet.
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ás időben jelzi az időpontokat.
PMDesignator	Meghatározza azt a sztringet, amely a 12 órás órákban déltől éjfélig tartó időt jelzi.

Ingatlan	Leírás
RFC1123Pattern	Az eredménysztring formátumát határozza meg.
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.

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

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

Megosztás:

Standard dátum- és időformátum-sztringek

Formátumjelö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átumjelö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átumválasztó

Az RFC1123 ("R", "r") formátumjelö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átumjelölője

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

DateOnly és TimeOnly formázás

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

DateTimeFormatInfo tulajdonságai

Lásd még

Visszacsatolás

További források