Standardní řetězce formátu data a času

Článek
04/11/2023

Řetězec standardního formátu data a času používá jeden znak jako specifikátor formátu k definování textové reprezentace DateTime hodnoty nebo DateTimeOffset . Jakýkoli řetězec formátu data a času, který obsahuje více než jeden znak, včetně prázdných znaků, je interpretován jako vlastní řetězec formátu data a času. Řetězec standardního nebo vlastního formátu lze používat dvěma způsoby:

Chcete-li definovat řetězec, který je výsledkem operace formátování.
Chcete-li definovat textové vyjádření hodnoty data a času, kterou lze převést na DateTime hodnotu nebo DateTimeOffset pomocí operace analýzy.

Tip

Můžete si stáhnout formátovací nástroj, aplikaci .NET model Windows Forms, která umožňuje použít formátovací řetězce na číselné hodnoty nebo hodnoty data a času a zobrazit výsledný řetězec. Zdrojový kód je k dispozici pro C# a Visual Basic.

Poznámka

Některé z příkladů jazyka C# v tomto článku se spouští v Try.NET vložené runner kódu a playground. Výběrem tlačítka Spustit spusťte příklad v interaktivním okně. Jakmile spustíte kód, můžete ho upravit a spustit upravený kód tak, že znovu vyberete Spustit . Upravený kód se buď spustí v interaktivním okně, nebo pokud kompilace selže, zobrazí se v interaktivním okně všechny chybové zprávy kompilátoru jazyka C#.

Místní časové pásmo Try.NET vloženého běžce kódu a hřiště je koordinovaný univerzální čas (UTC). To může ovlivnit chování a výstup příkladů, které ilustrují DateTimetypy , DateTimeOffseta TimeZoneInfo a jejich členy.

Tabulka specifikátorů formátu

Následující tabulka popisuje standardní specifikátory formátu data a času. Pokud není uvedeno jinak, konkrétní specifikátor standardního formátu data a času vytvoří identickou řetězcovou reprezentaci bez ohledu na to, zda se používá s DateTime hodnotou nebo DateTimeOffset . Další informace o použití řetězců standardního formátu data a času najdete v tématu nastavení Ovládací panely a vlastnosti DateTimeFormatInfo.

Specifikátor formátu	Popis	Příklady
"d"	Vzor krátkého formátu data. Další informace:Specifikátor krátkého formátu data ("d").	2009-06-15T13:45:30 -> 6/15/2009 (cs) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	Vzor dlouhého formátu data. Další informace:Specifikátor dlouhého formátu data ("D").	2009-06-15T13:45:30 -> Pondělí, Červen 15, 2009 (cs) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f"	Vzor úplného formátu data/času (krátkého formátu času). Další informace: Specifikátor úplného krátkého formátu data ("f").	2009-06-15T13:45:30 -> Pondělí, 15 Červen 2009 13:45 PM (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"	Vzor úplného formátu data/času (dlouhého formátu času). Další informace: Specifikátor úplného formátu data a dlouhého času (F).	2009-06-15T13:45:30 -> Monday, June 15, 2009 13:45:30 PM (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"	Vzor obecného formátu data/času (krátkého formátu času). Další informace: Specifikátor obecného formátu data a krátkého času ("g").	2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (cs-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"	Vzor obecného formátu data a času (dlouhého formátu času). Další informace: Specifikátor obecného formátu data a dlouhého času (G).	2009-06-15T13:45:30 -> 6/15/2009 13:45:30 PM (cs-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"	Vzor formátu měsíce/dne. Další informace: Specifikátor formátu měsíce ("M", "m").	2009-06-15T13:45:30 -> June 15 (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o"	vzor pro datum/čas doby jízdy. Další informace: Specifikátor formátu odezvy ("O", "o")	DateTime Hodnoty: 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.00000000 DateTimeOffset Hodnoty: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.000000-07:00
"R", "r"	Vzor RFC1123. Další informace: Specifikátor formátu RFC1123 ("R", "r")	DateTimeOffset vstup: 2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT DateTime vstup: 2009-06-15T13:45:30 -> Mon, 15 Jun 2009 13:45:30 GMT
"s"	Vzor seřaditelného formátu data/času. Další informace: Specifikátor formátu řazení ("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"	Vzor krátkého formátu času. Další informace: Specifikátor krátkého formátu ("t")	2009-06-15T13:45:30 -> 13:45 PM (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	Vzor dlouhého formátu času. Další informace: Specifikátor dlouhého formátu ("T").	2009-06-15T13:45:30 -> 13:45:30 PM (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u"	Vzor univerzálního seřaditelného formátu data/času. Další informace: Specifikátor univerzálního formátu řazení ("u").	DateTime S hodnotou: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z DateTimeOffset S hodnotou: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Vzor univerzálního úplného formátu data/času. Další informace: Specifikátor univerzálního úplného formátu ("U").	2009-06-15T13:45:30 -> Monday, June 15, 2009 20:45:30 PM (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"	Vzor formátu roku a měsíce. Další informace: Specifikátor formátu měsíce roku ("Y").	2009-06-15T13:45:30 -> Červen 2009 (cs-CZ) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Jakýkoli jiný samostatný znak	Neznámý specifikátor.	Vyvolá běhovou dobu FormatException.

Jak fungují řetězce standardního formátu

V rámci operace formátování je řetězec standardního formátu pouze aliasem pro řetězec vlastního formátu. Výhodou používání aliasu pro odkaz na řetězec vlastního formátu je skutečnost, že ačkoli alias zůstane neutrální, řetězec vlastního formátu se může změnit. Toto je důležité, protože řetězcová reprezentace hodnot data a času se obvykle liší podle jazykové verze. Například řetězec standardního formátu "d" označuje, že hodnota data a času má být zobrazena pomocí vzoru krátkého formátu data. Pro neutrální jazykovou verzi je použit formát "MM/dd/yyyy". Pro jazykovou verzi fr-FR je to formát "dd/MM/yyyy". Pro jazykovou verzi ja-JP je to formát "yyyy/MM/dd".

Pokud je řetězec standardního formátu v rámci operace formátování namapován na řetězec vlastního formátu konkrétní jazykové verze, může vaše aplikace definovat konkrétní jazykovou verzi, jejíž řetězce vlastního formátu se používají jedním z těchto způsobů:

Můžete použít výchozí (nebo aktuální) jazykovou verzi. Následující příklad zobrazí datum pomocí krátkého formátu data aktuální jazykové verze. V tomto případě je aktuální jazyková verze nastavena na 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

Objekt představující jazykovou CultureInfo verzi, jejíž formátování se má použít, můžete předat metodě, která má IFormatProvider parametr. Následující příklad zobrazí datum pomocí formátu krátkého data jazykové verze pt-BR.

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

Objekt, který poskytuje informace o formátování, můžete předat DateTimeFormatInfo metodě, která má IFormatProvider parametr . Následující příklad zobrazí datum pomocí krátkého formátu data z objektu DateTimeFormatInfo pro jazykovou verzi hr-HR.

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

Poznámka

Informace o přizpůsobení vzorů nebo řetězců používaných při formátování hodnot data a času najdete v NumberFormatInfo tématu třídy.

V některých případech slouží řetězec standardního formátu jako vhodná zkratka pro řetězec vlastního delšího formátu, který je neutrální. Do této kategorie patří čtyři řetězce standardního formátu: "O" (nebo "o"), "R" (nebo "r"), "s" a "u". Tyto řetězce odpovídají řetězcům vlastního formátu, které jsou definovány neutrální jazykovou verzí. Vytvářejí řetězcové reprezentace hodnot data a času, které mají být identické napříč jazykovými verzemi. Následující tabulka obsahuje informace o těchto čtyřech řetězcích standardního formátu data a času.

Řetězec standardního formátu	Definovaný vlastností DateTimeFormatInfo.InvariantInfo	Řetězec vlastního formátu
"O" nebo "o"	Žádné	yyyy'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffK
"R" nebo "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'

Standardní formátovací řetězce lze také použít při operacích parsování pomocí DateTime.ParseExact metod nebo DateTimeOffset.ParseExact , které vyžadují, aby vstupní řetězec přesně odpovídal určitému vzoru, aby operace parsování byla úspěšná. Mnoho řetězců standardního formátu je namapováno na několik řetězců vlastního formátu. Hodnotu data a času lze tedy vyjádřit v celé řadě formátů a operace analýzy i tak proběhne úspěšně. Vlastní formátovací řetězec nebo řetězce, které odpovídají řetězci standardního formátu, můžete určit voláním DateTimeFormatInfo.GetAllDateTimePatterns(Char) metody . Následující příklad zobrazí řetězce vlastního formátu, které mapují řetězec standardního formátu "d" (vzor krátkého formátu data).

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

Následující části popisují standardní specifikátory formátu pro DateTime hodnoty a DateTimeOffset .

Formáty data

Tato skupina zahrnuje následující formáty:

Specifikátor krátkého formátu data ("d")
Specifikátor dlouhého formátu data ("D")

Specifikátor krátkého formátu data ("d")

Specifikátor standardního formátu "d" představuje vlastní řetězec formátu data a času, který je definován vlastností konkrétní jazykové verze DateTimeFormatInfo.ShortDatePattern . Například řetězec vlastního formátu vrácený ShortDatePattern vlastností invariantní jazykové verze je "MM/dd/yyyy".

Následující tabulka uvádí vlastnosti objektu DateTimeFormatInfo , které řídí formátování vráceného řetězce.

Vlastnost	Popis
ShortDatePattern	Definuje celkový formát výsledného řetězce.
DateSeparator	Definuje řetězec, který u data odděluje komponenty roku, měsíce a dne.

Následující příklad používá specifikátor formátu "d" k zobrazení hodnoty data a času.

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

Vlastnost	Popis
LongDatePattern	Definuje celkový formát výsledného řetězce.
DayNames	Definuje lokalizované názvy dní, které mohou být zobrazeny ve výsledném řetězci.
MonthNames	Definuje lokalizované názvy měsíců, které mohou být zobrazeny ve výsledném řetězci.

Vlastnost	Popis
LongDatePattern	Definuje formát komponenty data výsledného řetězce.
ShortTimePattern	Definuje formát komponenty času výsledného řetězce.
DayNames	Definuje lokalizované názvy dní, které mohou být zobrazeny ve výsledném řetězci.
MonthNames	Definuje lokalizované názvy měsíců, které mohou být zobrazeny ve výsledném řetězci.
TimeSeparator	Definuje řetězec, který odděluje komponenty hodiny, minuty a sekundy v časovém údaji.
AMDesignator	Definuje řetězec, který označuje dobu od půlnoci do doby před polednem ve 12hodinovém formátu.
PMDesignator	Definuje řetězec, který označuje dobu od poledne do doby před půlnocí ve 12hodinovém formátu.

Vlastnost	Popis
FullDateTimePattern	Definuje celkový formát výsledného řetězce.
DayNames	Definuje lokalizované názvy dní, které mohou být zobrazeny ve výsledném řetězci.
MonthNames	Definuje lokalizované názvy měsíců, které mohou být zobrazeny ve výsledném řetězci.
TimeSeparator	Definuje řetězec, který odděluje komponenty hodiny, minuty a sekundy v časovém údaji.
AMDesignator	Definuje řetězec, který označuje dobu od půlnoci do doby před polednem ve 12hodinovém formátu.
PMDesignator	Definuje řetězec, který označuje dobu od poledne do doby před půlnocí ve 12hodinovém formátu.

Vlastnost	Popis
ShortDatePattern	Definuje formát komponenty data výsledného řetězce.
LongTimePattern	Definuje formát komponenty času výsledného řetězce.
DateSeparator	Definuje řetězec, který u data odděluje komponenty roku, měsíce a dne.
TimeSeparator	Definuje řetězec, který odděluje komponenty hodiny, minuty a sekundy v časovém údaji.
AMDesignator	Definuje řetězec, který označuje dobu od půlnoci do doby před polednem ve 12hodinovém formátu.
PMDesignator	Definuje řetězec, který označuje dobu od poledne do doby před půlnocí ve 12hodinovém formátu.

Vlastnost	Popis
RFC1123Pattern	Definuje formát výsledného řetězce.
AbbreviatedDayNames	Definuje zkrácené názvy dní, které mohou být zobrazeny ve výsledném řetězci.
AbbreviatedMonthNames	Definuje zkrácené názvy měsíců, které mohou být zobrazeny ve výsledném řetězci.

Vlastnost	Popis
MonthDayPattern	Definuje celkový formát výsledného řetězce.
MonthNames	Definuje lokalizované názvy měsíců, které mohou být zobrazeny ve výsledném řetězci.

Vlastnost	Popis
YearMonthPattern	Definuje celkový formát výsledného řetězce.
MonthNames	Definuje lokalizované názvy měsíců, které mohou být zobrazeny ve výsledném řetězci.

Sdílet prostřednictvím

Standardní řetězce formátu data a času

Tabulka specifikátorů formátu

Jak fungují řetězce standardního formátu

Formáty data

Specifikátor krátkého formátu data ("d")

Specifikátor dlouhého formátu data ("D")

Formáty data a času

Specifikátor úplného formátu krátkého času ("f")

Specifikátor úplného formátu data a dlouhého času ("F")

Specifikátor obecného formátu data a krátkého času ("g")

Specifikátor obecného formátu data a dlouhého času (G)

Specifikátor formátu odezvy ("O", "o")

Specifikátor formátu RFC1123 ("R", "r")

Specifikátor formátu řazení ("s")

Specifikátor formátu univerzálního řazení ("u")

Specifikátor univerzálního úplného formátu ("U")

Formáty času

Specifikátor formátu short time ("t")

Specifikátor formátu long time ("T")

Částečné formáty kalendářních dat

Specifikátor formátu měsíce ("M", "m")

Specifikátor formátu year month ("Y", "y")

nastavení Ovládací panely

Vlastnosti DateTimeFormatInfo

Viz také

Další materiály