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

2025-03-22

Standardní řetězec formátu data a času používá jeden znak jako specifikátor formátu k definování textové reprezentace DateTime nebo DateTimeOffset hodnoty. Jakýkoli řetězec formátu data a času, který obsahuje více než jeden znak včetně prázdných znaků, se interpretuje jako vlastní řetězec formátu data a času. Řetězec standardního nebo vlastního formátu lze použít 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, které lze převést na DateTime nebo DateTimeOffset hodnotu pomocí operace analýzy.

Doporučení

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

Poznámka:

Některé příklady jazyka C# v tomto článku běží v Try.NET vloženého spouštěče kódu a dětského hřiště. Výběrem tlačítka Spustit spusťte příklad v interaktivním okně. Jakmile kód spustíte, 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 inline code runner a playground je koordinovaný univerzální čas (UTC). To může ovlivnit chování a výstup příkladů, které ilustrují DateTime, DateTimeOffseta TimeZoneInfo typy 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 formátu data a času vytvoří identické řetězcové vyjádření bez ohledu na to, zda se používá s DateTime nebo hodnotou DateTimeOffset. Další informace o použití standardních řetězců formátu data a času najdete v tématu Nastavení ovládacích panelů a vlastnosti DateTimeFormatInfo.

Specifikátor formátu	Popis	Příklady
"d"	Vzor krátkého formátu data. Další informace:Specifikátor formátu krátkého data ("d").	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"	Vzor dlouhého formátu data. Další informace:Specifikátor formátu dlouhého data ("D").	2009-06-15T13:45:30 –> pondělí 15. června 2009 (en-US) 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 formátu full date short time ("f")	2009-06-15T13:45:30 –> pondělí 15. června 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"	Vzor úplného formátu data/času (dlouhého formátu času). Další informace: Specifikátor formátu full date long time ("F")	2009-06-15T13:45:30 –> pondělí 15. června 2009 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"	Vzor obecného formátu data/času (krátkého formátu času). Další informace: Specifikátor formátu obecný krátký čas data ("g").	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"	Vzor obecného formátu data a času (dlouhého formátu času). Další informace: Specifikátor obecného formátu data dlouhého času ("G").	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"	Vzor formátu měsíce/dne. Další informace: Specifikátor formátu měsíce ("M", "m")	2009-06-15T13:45:30 –> 15. června (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o"	vzor data a času odezvy. 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.000000Z 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.0000000-07:00
"R", "r"	Vzor RFC1123. Další informace: Specifikátor formátu RFC1123 ("R", "r")	DateTimeOffset vstup: 2009-06-15T13:45:30 -> Po, 15. června 2009 20:45:30 GMT DateTime vstup: 2009-06-15T13:45:30 -> Po, 15. června 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 formátu krátkého času ("t").	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"	Vzor dlouhého formátu času. Další informace: Specifikátor formátu dlouhého času ("T").	2009-06-15T13:45:30 -> 1: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").	S hodnotou DateTime: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z S hodnotou DateTimeOffset: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Vzor univerzálního úplného data a času Další informace: Specifikátor univerzálního úplného formátu ("U").	2009-06-15T13:45:30 -> pondělí, 15. června 2009 8: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"	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 (en-US) 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á FormatExceptionza běhu .

Jak fungují standardní formátovací řetězce

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

Můžete předat objekt CultureInfo představující jazykovou verzi, jejíž formátování se má použít pro metodu, 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 DateTimeFormatInfo, který poskytuje informace o formátování 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žitých při formátování hodnot data a času najdete v tématu NumberFormatInfo 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	Definováno dateTimeFormatInfo.InvariantInfo vlastnost	Ř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 parsování operací s metodami DateTime.ParseExact nebo DateTimeOffset.ParseExact, které vyžadují, aby vstupní řetězec přesně odpovídal určitému vzoru, aby operace analýzy byla úspěšná. Mnoho standardních řetězců formátu se mapuje na více řetězců vlastního formátu, takže hodnotu data a času lze reprezentovat v různých formátech a operace analýzy bude stále úspěšná. Řetězec vlastního formátu nebo řetězce, které odpovídají standardnímu formátovacímu řetězci, můžete určit voláním metody DateTimeFormatInfo.GetAllDateTimePatterns(Char). Následující příklad zobrazí řetězce vlastního formátu, které se mapují na řetězec standardního formátu "d" (vzor krátkého 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($"   {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 a DateTimeOffset hodnoty.

Formáty kalendářních dat

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

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

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

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

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

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

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

Vlastnictví	Popis
LongDatePattern	Definuje celkový formát výsledného řetězce.
DayNames	Definuje lokalizované názvy dnů, které se můžou zobrazit ve výsledném řetězci.
MonthNames	Definuje lokalizované názvy měsíců, které se můžou zobrazit ve výsledném řetězci.

Vlastnictví	Popis
LongDatePattern	Definuje formát komponenty data výsledného řetězce.
ShortTimePattern	Definuje formát časové komponenty výsledného řetězce.
DayNames	Definuje lokalizované názvy dnů, které se můžou zobrazit ve výsledném řetězci.
MonthNames	Definuje lokalizované názvy měsíců, které se můžou zobrazit ve výsledném řetězci.
TimeSeparator	Definuje řetězec, který odděluje hodiny, minuty a druhé součásti času.
AMDesignator	Definuje řetězec, který označuje časy od půlnoci do poledne ve 12hodinovém formátu.
PMDesignator	Definuje řetězec, který označuje časy od poledne do před půlnocí ve 12hodinovém formátu.

Vlastnictví	Popis
FullDateTimePattern	Definuje celkový formát výsledného řetězce.
DayNames	Definuje lokalizované názvy dnů, které se můžou zobrazit ve výsledném řetězci.
MonthNames	Definuje lokalizované názvy měsíců, které se můžou zobrazit ve výsledném řetězci.
TimeSeparator	Definuje řetězec, který odděluje hodiny, minuty a druhé součásti času.
AMDesignator	Definuje řetězec, který označuje časy od půlnoci do poledne ve 12hodinovém formátu.
PMDesignator	Definuje řetězec, který označuje časy od poledne do před půlnocí ve 12hodinovém formátu.

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

Vlastnictví	Popis
RFC1123Pattern	Definuje formát výsledného řetězce.
AbbreviatedDayNames	Definuje zkrácené názvy dnů, které se můžou zobrazit ve výsledném řetězci.
AbbreviatedMonthNames	Definuje zkrácené názvy měsíců, které se můžou zobrazit ve výsledném řetězci.

Vlastnictví	Popis
MonthDayPattern	Definuje celkový formát výsledného řetězce.
MonthNames	Definuje lokalizované názvy měsíců, které se můžou zobrazit ve výsledném řetězci.

Vlastnictví	Popis
YearMonthPattern	Definuje celkový formát výsledného řetězce.
MonthNames	Definuje lokalizované názvy měsíců, které se můžou zobrazit 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í standardní formátovací řetězce

Formáty kalendářních dat

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

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

Formáty data a času

Specifikátor formátu full date short time ("f")

Specifikátor formátu full date long time ("F")

Specifikátor obecného formátu data short time ("g")

Specifikátor obecného formátu data long time ("G")

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

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

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

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

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

Formáty času

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

Specifikátor formátu dlouhého času ("T")

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

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

Specifikátor formátu roku ("Y", "y")

Nastavení Ovládacích panelů

Vlastnosti DateTimeFormatInfo

Viz také

Váš názor

Další materiály