Standardní řetězce formátu data a časuStandard Date and Time Format Strings

Řetězec standardního formátu data a času používá pro definování textového vyjádření hodnoty data a času jeden specifikátor formátu.A standard date and time format string uses a single format specifier to define the text representation of a date and time value. Libovolný řetězec formátu data a času, který obsahuje více než jeden znak, včetně prázdných znaků, je interpretován jako řetězec vlastního formátu data a času. Další informace naleznete v tématu Vlastní řetězce formátu data a času.Any date and time format string that contains more than one character, including white space, is interpreted as a custom date and time format string; for more information, see Custom Date and Time Format Strings. Řetězec standardního nebo vlastního formátu lze používat dvěma způsoby:A standard or custom format string can be used in two ways:

  • Chcete-li definovat řetězec, který je výsledkem operace formátování.To define the string that results from a formatting operation.

  • Chcete-li definovat textovou reprezentaci hodnoty data a času, která může být převedena DateTimeOffset na DateTime hodnotu nebo pomocí operace analýzy.To define the text representation of a date and time value that can be converted to a DateTime or DateTimeOffset value by a parsing operation.

Tip

Můžete si stáhnout formátovací nástroj, aplikaci .net Core model Windows Forms, která umožňuje použití řetězců formátu na číselné hodnoty nebo hodnoty data a času a zobrazuje výsledný řetězec.You can download the Formatting Utility, a .NET Core Windows Forms application that lets you apply format strings to either numeric or date and time values and displays the result string. Zdrojový kód je k dispozici pro C# a Visual Basic.Source code is available for C# and Visual Basic.

Řetězce standardního formátu data a času lze použít s DateTime DateTimeOffset hodnotami i.Standard date and time format strings can be used with both DateTime and DateTimeOffset values.

Poznámka

Některé příklady jazyka C# v tomto článku spustit Try.NET runner a playground vloženého kódu.Some of the C# examples in this article run in the Try.NET inline code runner and playground. Vyberte spustit tlačítko spustit příklad v interaktivním okně.Select the Run button to run an example in an interactive window. Jakmile se při spuštění kódu, můžete upravit a spustit upravený kód tak, že vyberete spustit znovu.Once you execute the code, you can modify it and run the modified code by selecting Run again. Upravené kód je buď spuštěn v interaktivním okně, nebo pokud kompilace se nezdaří, interaktivní okno zobrazuje všechny jazyka C# kompilátoru chybové zprávy.The modified code either runs in the interactive window or, if compilation fails, the interactive window displays all C# compiler error messages.

Místní časové pásmo z Try.NET vložený kód spouštěče a playground je koordinovaný světový čas nebo čas UTC.The local time zone of the Try.NET inline code runner and playground is Coordinated Universal Time, or UTC. To může mít vliv chování a výstup příklady znázorňující, DateTime, DateTimeOffset, a TimeZoneInfo typů a jejich členy.This may affect the behavior and the output of examples that illustrate the DateTime, DateTimeOffset, and TimeZoneInfo types and their members.

Následující tabulka popisuje standardní specifikátory formátu data a času.The following table describes the standard date and time format specifiers. Není-li uvedeno jinak, konkrétní specifikátor standardního formátu data a času vytváří identickou řetězcovou reprezentaci bez ohledu na to, zda DateTime je použit DateTimeOffset s hodnotou nebo.Unless otherwise noted, a particular standard date and time format specifier produces an identical string representation regardless of whether it is used with a DateTime or a DateTimeOffset value. Další informace o použití řetězců standardního formátu data a času naleznete v části poznámky .See the Notes section for additional information about using standard date and time format strings.

Specifikátor formátuFormat specifier PopisDescription PříkladyExamples
"d""d" Vzor krátkého formátu data.Short date pattern.

Další informace:specifikátor krátkého formátu data ("d").More information:The Short Date ("d") Format Specifier.
2009-06-15T13:45:30 > 6/15/2009 (EN-US)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 -> 15/06/2009 (fr-FR)

2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D""D" Vzor dlouhého formátu data.Long date pattern.

Další informace:specifikátor dlouhého formátu data ("D").More information:The Long Date ("D") Format Specifier.
2009-06-15T13:45:30 > pondělí, 15. června 2009 (EN-US)2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)

2009-06-15T13:45:30 -> 15 июня 2009 г.2009-06-15T13:45:30 -> 15 июня 2009 г. (ru-RU)(ru-RU)

2009-06-15T13:45:30-> Montag, 15.2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)Juni 2009 (de-DE)
"f""f" Vzor úplného formátu data/času (krátkého formátu času).Full date/time pattern (short time).

Další informace: Specifikátor úplného formátu data a krátkého formátu času ("f").More information: The Full Date Short Time ("f") Format Specifier.
2009-06-15T13:45:30-> pondělí, 15. června 2009 1:45 odp. (EN-US)2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US)

2009-06-15T13:45:30-> den 15 Juni 2009 13:45 (sv-SE)2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F""F" Vzor úplného formátu data/času (dlouhého formátu času).Full date/time pattern (long time).

Další informace: Specifikátor úplného formátu data a dlouhého formátu času ("F").More information: The Full Date Long Time ("F") Format Specifier.
2009-06-15T13:45:30-> pondělí, 15. června 2009 1:45:30 ODP. (EN-US)2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US)

2009-06-15T13:45:30-> den 15 Juni 2009 13:45:30 (sv-SE)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)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g""g" Vzor obecného formátu data/času (krátkého formátu času).General date/time pattern (short time).

Další informace: Specifikátor obecného formátu data a krátkého formátu času ("g").More information: The General Date Short Time ("g") Format Specifier.
2009-06-15T13:45:30-> 6/15/2009 1:45 odp. (EN-US)2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US)

2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES)2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES)

2009-06-15T13:45:30. > 2009/6/15 13:45 (zh-CN)2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G""G" Vzor obecného formátu data a času (dlouhého formátu času).General date/time pattern (long time).

Další informace: Specifikátor obecného formátu data a dlouhého formátu času ("G").More information: The General Date Long Time ("G") Format Specifier.
2009-06-15T13:45:30-> 6/15/2009 1:45:30 ODP. (EN-US)2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US)

2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES)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)2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m""M", "m" Vzor formátu měsíce/dne.Month/day pattern.

Další informace: Specifikátor formátu měsíce ("m", "m").More information: The Month ("M", "m") Format Specifier.
2009-06-15T13:45:30-> 15. června (EN-US)2009-06-15T13:45:30 -> June 15 (en-US)

2009-06-15T13:45:30 -> 15.2009-06-15T13:45:30 -> 15. Juni (da-DK)juni (da-DK)

2009-06-15T13:45:30 – > 15 Juni (ID-ID)2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o""O", "o" Vzor formátu data/času zpátečního převodu.Round-trip date/time pattern.

Další informace: Specifikátor formátu Round-Trip ("o", "o").More information: The Round-trip ("O", "o") Format Specifier.
DateTimehodnotaDateTime values:

2009-06-15T13:45:30 (DateTimeKind. Local)--> 2009-06-15T13:45:30.0000000-07:002009-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.0000000 Z2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z

2009-06-15T13:45:30 (DateTimeKind. unspecifikovaná)--> 2009-06-15T13:45:30.00000002009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000

DateTimeOffsethodnotaDateTimeOffset values:

2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:002009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
"R", "r""R", "r" Vzor RFC1123.RFC1123 pattern.

Další informace: Specifikátor formátu RFC1123 ("r", "r").More information: The RFC1123 ("R", "r") Format Specifier.
2009-06-15T13:45:30-> Mon, 15. června 2009 20:45:30 GMT2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT
"s""s" Vzor seřaditelného formátu data/času.Sortable date/time pattern.

Další informace: Specifikátor formátu, který lze seřadit ("s").More information: The Sortable ("s") Format Specifier.
2009-06-15T13:45:30 (DateTimeKind. Local)-> 2009-06-15T13:45:302009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30

2009-06-15T13:45:30 (DateTimeKind. UTC)-> 2009-06-15T13:45:302009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
"t""t" Vzor krátkého formátu času.Short time pattern.

Další informace: Specifikátor krátkého formátu času ("t").More information: The Short Time ("t") Format Specifier.
2009-06-15T13:45:30-> 1:45 odp. (EN-US)2009-06-15T13:45:30 -> 1:45 PM (en-US)

2009-06-15T13:45:30 > 13:45 (HR-HR)2009-06-15T13:45:30 -> 13:45 (hr-HR)

2009-06-15T13:45:30-> 01:45 م (ar-EG)2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T""T" Vzor dlouhého formátu času.Long time pattern.

Další informace: Specifikátor dlouhého formátu času ("T").More information: The Long Time ("T") Format Specifier.
2009-06-15T13:45:30-> 1:45:30 ODP. (EN-US)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 -> 13:45:30 (hr-HR)

2009-06-15T13:45:30-> 01:45:30 م (ar-EG)2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u""u" Vzor univerzálního seřaditelného formátu data/času.Universal sortable date/time pattern.

Další informace: Univerzální specifikátor formátu ("u").More information: The Universal Sortable ("u") Format Specifier.
DateTime S hodnotou: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30ZWith a DateTime value: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z

DateTimeOffset S hodnotou: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30ZWith a DateTimeOffset value: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U""U" Vzor univerzálního úplného formátu data/času.Universal full date/time pattern.

Další informace: Specifikátor univerzálního úplného formátu ("U").More information: The Universal Full ("U") Format Specifier.
2009-06-15T13:45:30-> pondělí, 15. června 2009 8:45:30 ODP. (EN-US)2009-06-15T13:45:30 -> Monday, June 15, 2009 8:45:30 PM (en-US)

2009-06-15T13:45:30-> den 15 Juni 2009 20:45:30 (sv-SE)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)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
"Y", "y""Y", "y" Vzor formátu roku a měsíce.Year month pattern.

Další informace: Specifikátor formátu roku a měsíce ("Y").More information: The Year Month ("Y") Format Specifier.
2009-06-15T13:45:30-> června, 2009 (EN-US)2009-06-15T13:45:30 -> June, 2009 (en-US)

2009-06-15T13:45:30-> Juni 2009 (da-DK)2009-06-15T13:45:30 -> juni 2009 (da-DK)

2009-06-15T13:45:30-> Juni 2009 (ID-ID)2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Jakýkoli jiný samostatný znakAny other single character Neznámý specifikátor.Unknown specifier. Vyvolá dobu FormatExceptionběhu.Throws a run-time FormatException.

Jak fungují řetězce standardního formátuHow Standard Format Strings Work

V rámci operace formátování je řetězec standardního formátu pouze aliasem pro řetězec vlastního formátu.In a formatting operation, a standard format string is simply an alias for a custom format string. 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.The advantage of using an alias to refer to a custom format string is that, although the alias remains invariant, the custom format string itself can vary. Toto je důležité, protože řetězcová reprezentace hodnot data a času se obvykle liší podle jazykové verze.This is important because the string representations of date and time values typically vary by culture. 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.For example, the "d" standard format string indicates that a date and time value is to be displayed using a short date pattern. Pro neutrální jazykovou verzi je použit formát "MM/dd/yyyy".For the invariant culture, this pattern is "MM/dd/yyyy". Pro jazykovou verzi fr-FR je to formát "dd/MM/yyyy".For the fr-FR culture, it is "dd/MM/yyyy". Pro jazykovou verzi ja-JP je to formát "yyyy/MM/dd".For the ja-JP culture, it is "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ů:If a standard format string in a formatting operation maps to a particular culture's custom format string, your application can define the specific culture whose custom format strings are used in one of these ways:

  • Můžete použít výchozí (nebo aktuální) jazykovou verzi.You can use the default (or current) culture. Následující příklad zobrazí datum pomocí krátkého formátu data aktuální jazykové verze.The following example displays a date using the current culture's short date format. V tomto případě je aktuální jazyková verze nastavena na en-US.In this case, the current culture is 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 CultureInfo objekt reprezentující jazykovou verzi, jejíž formátování má být použito pro metodu, která IFormatProvider má parametr.You can pass a CultureInfo object representing the culture whose formatting is to be used to a method that has an IFormatProvider parameter. Následující příklad zobrazí datum pomocí formátu krátkého data jazykové verze pt-BR.The following example displays a date using the short date format of the pt-BR culture.

    // 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
    
  • Můžete předat DateTimeFormatInfo objekt, který poskytuje informace o formátování metodě, která IFormatProvider má parametr.You can pass a DateTimeFormatInfo object that provides formatting information to a method that has an IFormatProvider parameter. Následující příklad zobrazí datum pomocí formátu krátkého data z DateTimeFormatInfo objektu pro jazykovou verzi hr-hr.The following example displays a date using the short date format from a DateTimeFormatInfo object for the hr-HR culture.

    // 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 naleznete NumberFormatInfo v tématu třídy.For information about customizing the patterns or strings used in formatting date and time values, see the NumberFormatInfo class topic.

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í.In some cases, the standard format string serves as a convenient abbreviation for a longer custom format string that is invariant. Do této kategorie patří čtyři standardní formátovací řetězce: "O" (nebo "o"), "R" (nebo "r"), "s" a "u".Four standard format strings fall into this category: "O" (or "o"), "R" (or "r"), "s", and "u". Tyto řetězce odpovídají řetězcům vlastního formátu, které jsou definovány neutrální jazykovou verzí.These strings correspond to custom format strings defined by the invariant culture. Vytvářejí řetězcové reprezentace hodnot data a času, které mají být identické napříč jazykovými verzemi.They produce string representations of date and time values that are intended to be identical across cultures. Následující tabulka obsahuje informace o těchto čtyřech řetězcích standardního formátu data a času.The following table provides information on these four standard date and time format strings.

Řetězec standardního formátuStandard format string Definovaný vlastností DateTimeFormatInfo.InvariantInfoDefined by DateTimeFormatInfo.InvariantInfo property Řetězec vlastního formátuCustom format string
"O" nebo "o""O" or "o" ŽádnéNone yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzyyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzz
"R" nebo "r""R" or "r" RFC1123Pattern ddd, dd MMM yyyy HH':'mm':'ss 'GMT'ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s""s" SortableDateTimePattern yyyy'-'MM'-'dd'T'HH':'mm':'ssyyyy'-'MM'-'dd'T'HH':'mm':'ss
"u""u" UniversalSortableDateTimePattern yyyy'-'MM'-'dd HH':'mm':'ss'Z'yyyy'-'MM'-'dd HH':'mm':'ss'Z'

Standardní formátovací řetězce lze také použít při analýze operací s DateTime.ParseExact metodami nebo DateTimeOffset.ParseExact , které vyžadují, aby vstupní řetězec přesně splňoval konkrétní vzor, aby operace analýzy mohla být úspěšná.Standard format strings can also be used in parsing operations with the DateTime.ParseExact or DateTimeOffset.ParseExact methods, which require an input string to exactly conform to a particular pattern for the parse operation to succeed. 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ě.Many standard format strings map to multiple custom format strings, so a date and time value can be represented in a variety of formats and the parse operation will still succeed. Můžete určit řetězec vlastního formátu nebo řetězce, které odpovídají standardnímu formátovacímu řetězci voláním DateTimeFormatInfo.GetAllDateTimePatterns(Char) metody.You can determine the custom format string or strings that correspond to a standard format string by calling the DateTimeFormatInfo.GetAllDateTimePatterns(Char) method. 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).The following example displays the custom format strings that map to the "d" (short date pattern) standard format string.

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. DateTimeOffsetThe following sections describe the standard format specifiers for DateTime and DateTimeOffset values.

Specifikátor krátkého formátu data ("d")The Short Date ("d") Format Specifier

Standardní specifikátor formátu "d" představuje řetězec vlastního formátu data a času, který je definován DateTimeFormatInfo.ShortDatePattern vlastností konkrétní jazykové verze.The "d" standard format specifier represents a custom date and time format string that is defined by a specific culture's DateTimeFormatInfo.ShortDatePattern property. Například řetězec vlastního formátu, který je vrácen ShortDatePattern vlastností invariantní jazykové verze, je "mm/dd/rrrr".For example, the custom format string that is returned by the ShortDatePattern property of the invariant culture is "MM/dd/yyyy".

V následující tabulce jsou uvedeny DateTimeFormatInfo vlastnosti objektu, které řídí formátování vráceného řetězce.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

VlastnostProperty PopisDescription
ShortDatePattern Definuje celkový formát výsledného řetězce.Defines the overall format of the result string.
DateSeparator Definuje řetězec, který u data odděluje komponenty roku, měsíce a dne.Defines the string that separates the year, month, and day components of a date.

Následující příklad používá specifikátor formátu "d" k zobrazení hodnoty data a času.The following example uses the "d" format specifier to display a date and time value.

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                       

Zpět na tabulkuBack to table

Specifikátor dlouhého formátu data ("D")The Long Date ("D") Format Specifier

Standardní specifikátor formátu "D" představuje řetězec vlastního formátu data a času, který je definován aktuální DateTimeFormatInfo.LongDatePattern vlastností.The "D" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.LongDatePattern property. Například řetězec vlastního formátu pro neutrální jazykovou verzi je "dddd, dd MMMM yyyy".For example, the custom format string for the invariant culture is "dddd, dd MMMM yyyy".

V následující tabulce jsou uvedeny vlastnosti DateTimeFormatInfo objektu, které řídí formátování vráceného řetězce.The following table lists the properties of the DateTimeFormatInfo object that control the formatting of the returned string.

VlastnostProperty PopisDescription
LongDatePattern Definuje celkový formát výsledného řetězce.Defines the overall format of the result string.
DayNames Definuje lokalizované názvy dní, které mohou být zobrazeny ve výsledném řetězci.Defines the localized day names that can appear in the result string.
MonthNames Definuje lokalizované názvy měsíců, které mohou být zobrazeny ve výsledném řetězci.Defines the localized month names that can appear in the result string.

Následující příklad používá specifikátor formátu "D" k zobrazení hodnoty data a času.The following example uses the "D" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10);
Console.WriteLine(date1.ToString("D", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008                        
Console.WriteLine(date1.ToString("D", 
                  CultureInfo.CreateSpecificCulture("pt-BR")));
// Displays quinta-feira, 10 de abril de 2008                        
Console.WriteLine(date1.ToString("D", 
                  CultureInfo.CreateSpecificCulture("es-MX")));
// Displays jueves, 10 de abril de 2008                        
Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("D", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008                        
Console.WriteLine(date1.ToString("D", _
                  CultureInfo.CreateSpecificCulture("pt-BR")))
' Displays quinta-feira, 10 de abril de 2008                        
Console.WriteLine(date1.ToString("D", _
                  CultureInfo.CreateSpecificCulture("es-MX")))
' Displays jueves, 10 de abril de 2008                        

Zpět na tabulkuBack to table

Specifikátor úplného formátu data a krátkého formátu času ("f")The Full Date Short Time ("f") Format Specifier

Standardní specifikátor formátu "f" představuje kombinaci vzorů dlouhého formátu data "D" a krátkého formátu času "t", která je oddělena mezerou.The "f" standard format specifier represents a combination of the long date ("D") and short time ("t") patterns, separated by a space.

Výsledný řetězec je ovlivněn informacemi o formátování konkrétního DateTimeFormatInfo objektu.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. V následující tabulce jsou uvedeny DateTimeFormatInfo vlastnosti objektu, které mohou řídit formátování vráceného řetězce.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Vlastní specifikátor formátu vrácený DateTimeFormatInfo.LongDatePattern vlastnostmi a DateTimeFormatInfo.ShortTimePattern některých kultur nemusí využívat všechny vlastnosti.The custom format specifier returned by the DateTimeFormatInfo.LongDatePattern and DateTimeFormatInfo.ShortTimePattern properties of some cultures may not make use of all properties.

VlastnostProperty PopisDescription
LongDatePattern Definuje formát komponenty data výsledného řetězce.Defines the format of the date component of the result string.
ShortTimePattern Definuje formát komponenty času výsledného řetězce.Defines the format of the time component of the result string.
DayNames Definuje lokalizované názvy dní, které mohou být zobrazeny ve výsledném řetězci.Defines the localized day names that can appear in the result string.
MonthNames Definuje lokalizované názvy měsíců, které mohou být zobrazeny ve výsledném řetězci.Defines the localized month names that can appear in the result string.
TimeSeparator Definuje řetězec, který odděluje komponenty hodiny, minuty a sekundy v časovém údaji.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definuje řetězec, který označuje dobu od půlnoci do doby před polednem ve 12hodinovém formátu.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definuje řetězec, který označuje dobu od poledne do doby před půlnocí ve 12hodinovém formátu.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Následující příklad používá specifikátor formátu "f" k zobrazení hodnoty data a času.The following example uses the "f" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("f", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 6:30 AM                        
Console.WriteLine(date1.ToString("f", 
                  CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays jeudi 10 avril 2008 06:30                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("f", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 6:30 AM                        
Console.WriteLine(date1.ToString("f", _
                  CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays jeudi 10 avril 2008 06:30                       

Zpět na tabulkuBack to table

Specifikátor úplného formátu data a dlouhého formátu času ("F")The Full Date Long Time ("F") Format Specifier

Standardní specifikátor formátu "F" představuje řetězec vlastního formátu data a času, který je definován aktuální DateTimeFormatInfo.FullDateTimePattern vlastností.The "F" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.FullDateTimePattern property. Například řetězec vlastního formátu pro neutrální jazykovou verzi je "dddd, dd MMMM yyyy HH:mm:ss".For example, the custom format string for the invariant culture is "dddd, dd MMMM yyyy HH:mm:ss".

V následující tabulce jsou uvedeny DateTimeFormatInfo vlastnosti objektu, které mohou řídit formátování vráceného řetězce.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Specifikátor vlastního formátu, který je vrácen FullDateTimePattern vlastností některých kultur, nemusí využívat všechny vlastnosti.The custom format specifier that is returned by the FullDateTimePattern property of some cultures may not make use of all properties.

VlastnostProperty PopisDescription
FullDateTimePattern Definuje celkový formát výsledného řetězce.Defines the overall format of the result string.
DayNames Definuje lokalizované názvy dní, které mohou být zobrazeny ve výsledném řetězci.Defines the localized day names that can appear in the result string.
MonthNames Definuje lokalizované názvy měsíců, které mohou být zobrazeny ve výsledném řetězci.Defines the localized month names that can appear in the result string.
TimeSeparator Definuje řetězec, který odděluje komponenty hodiny, minuty a sekundy v časovém údaji.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definuje řetězec, který označuje dobu od půlnoci do doby před polednem ve 12hodinovém formátu.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definuje řetězec, který označuje dobu od poledne do doby před půlnocí ve 12hodinovém formátu.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Následující příklad používá specifikátor formátu "F" k zobrazení hodnoty data a času.The following example uses the "F" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("F", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("F", 
                  CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays jeudi 10 avril 2008 06:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("F", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("F", _
                  CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays jeudi 10 avril 2008 06:30:00                       

Zpět na tabulkuBack to table

Specifikátor obecného formátu data a krátkého formátu času ("g")The General Date Short Time ("g") Format Specifier

Standardní specifikátor formátu "g" představuje kombinaci vzorů krátkého formátu data "d" a krátkého formátu času "t", která je oddělena mezerou.The "g" standard format specifier represents a combination of the short date ("d") and short time ("t") patterns, separated by a space.

Výsledný řetězec je ovlivněn informacemi o formátování konkrétního DateTimeFormatInfo objektu.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. V následující tabulce jsou uvedeny DateTimeFormatInfo vlastnosti objektu, které mohou řídit formátování vráceného řetězce.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Specifikátor vlastního formátu, který je vrácen DateTimeFormatInfo.ShortDatePattern vlastnostmi a DateTimeFormatInfo.ShortTimePattern v některých jazykových verzích, nemusí využívat všechny vlastnosti.The custom format specifier that is returned by the DateTimeFormatInfo.ShortDatePattern and DateTimeFormatInfo.ShortTimePattern properties of some cultures may not make use of all properties.

VlastnostProperty PopisDescription
ShortDatePattern Definuje formát komponenty data výsledného řetězce.Defines the format of the date component of the result string.
ShortTimePattern Definuje formát komponenty času výsledného řetězce.Defines the format of the time component of the result string.
DateSeparator Definuje řetězec, který u data odděluje komponenty roku, měsíce a dne.Defines the string that separates the year, month, and day components of a date.
TimeSeparator Definuje řetězec, který odděluje komponenty hodiny, minuty a sekundy v časovém údaji.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definuje řetězec, který označuje dobu od půlnoci do doby před polednem ve 12hodinovém formátu.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definuje řetězec, který označuje dobu od poledne do doby před půlnocí ve 12hodinovém formátu.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Následující příklad používá specifikátor formátu "g" k zobrazení hodnoty data a času.The following example uses the "g" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("g", 
                  DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008 06:30                      
Console.WriteLine(date1.ToString("g", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 4/10/2008 6:30 AM                       
Console.WriteLine(date1.ToString("g", 
                  CultureInfo.CreateSpecificCulture("fr-BE")));
// Displays 10/04/2008 6:30                        
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("g", _
                  DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008 06:30                      
Console.WriteLine(date1.ToString("g", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 4/10/2008 6:30 AM                       
Console.WriteLine(date1.ToString("g", _
                  CultureInfo.CreateSpecificCulture("fr-BE")))
' Displays 10/04/2008 6:30                        

Zpět na tabulkuBack to table

Specifikátor obecného formátu data a dlouhého formátu času ("G")The General Date Long Time ("G") Format Specifier

Standardní specifikátor formátu "G" představuje kombinaci vzorů krátkého formátu data "d" a dlouhého formátu času "T", která je oddělena mezerou.The "G" standard format specifier represents a combination of the short date ("d") and long time ("T") patterns, separated by a space.

Výsledný řetězec je ovlivněn informacemi o formátování konkrétního DateTimeFormatInfo objektu.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. V následující tabulce jsou uvedeny DateTimeFormatInfo vlastnosti objektu, které mohou řídit formátování vráceného řetězce.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Specifikátor vlastního formátu, který je vrácen DateTimeFormatInfo.ShortDatePattern vlastnostmi a DateTimeFormatInfo.LongTimePattern v některých jazykových verzích, nemusí využívat všechny vlastnosti.The custom format specifier that is returned by the DateTimeFormatInfo.ShortDatePattern and DateTimeFormatInfo.LongTimePattern properties of some cultures may not make use of all properties.

VlastnostProperty PopisDescription
ShortDatePattern Definuje formát komponenty data výsledného řetězce.Defines the format of the date component of the result string.
LongTimePattern Definuje formát komponenty času výsledného řetězce.Defines the format of the time component of the result string.
DateSeparator Definuje řetězec, který u data odděluje komponenty roku, měsíce a dne.Defines the string that separates the year, month, and day components of a date.
TimeSeparator Definuje řetězec, který odděluje komponenty hodiny, minuty a sekundy v časovém údaji.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definuje řetězec, který označuje dobu od půlnoci do doby před polednem ve 12hodinovém formátu.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definuje řetězec, který označuje dobu od poledne do doby před půlnocí ve 12hodinovém formátu.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Následující příklad používá specifikátor formátu "G" k zobrazení hodnoty data a času.The following example uses the "G" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("G", 
                  DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008 06:30:00
Console.WriteLine(date1.ToString("G", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 4/10/2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("G", 
                  CultureInfo.CreateSpecificCulture("nl-BE")));
// Displays 10/04/2008 6:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("G", _
                  DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008 06:30:00
Console.WriteLine(date1.ToString("G", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 4/10/2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("G", _
                  CultureInfo.CreateSpecificCulture("nl-BE")))
' Displays 10/04/2008 6:30:00                       

Zpět na tabulkuBack to table

Specifikátor formátu měsíce ("M", "m")The Month ("M", "m") Format Specifier

Standardní specifikátor formátu "M" nebo "M" představuje řetězec vlastního formátu data a času, který je definován aktuální DateTimeFormatInfo.MonthDayPattern vlastností.The "M" or "m" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.MonthDayPattern property. Například řetězec vlastního formátu pro neutrální jazykovou verzi je "MMMM dd".For example, the custom format string for the invariant culture is "MMMM dd".

V následující tabulce jsou uvedeny DateTimeFormatInfo vlastnosti objektu, které řídí formátování vráceného řetězce.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

VlastnostProperty PopisDescription
MonthDayPattern Definuje celkový formát výsledného řetězce.Defines the overall format of the result string.
MonthNames Definuje lokalizované názvy měsíců, které mohou být zobrazeny ve výsledném řetězci.Defines the localized month names that can appear in the result string.

Následující příklad používá specifikátor formátu "m" k zobrazení hodnoty data a času.The following example uses the "m" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("m", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays April 10                        
Console.WriteLine(date1.ToString("m", 
                  CultureInfo.CreateSpecificCulture("ms-MY")));
// Displays 10 April                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("m", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays April 10                        
Console.WriteLine(date1.ToString("m", _
                  CultureInfo.CreateSpecificCulture("ms-MY")))
' Displays 10 April                       

Zpět na tabulkuBack to table

Specifikátor formátu zpátečního převodu ("O", "o")The Round-trip ("O", "o") Format Specifier

Standardní specifikátor formátu "O" nebo "o" představuje řetězec vlastního formátu data a času pomocí vzoru, který zachovává informace o časovém pásmu a generuje výsledný řetězec, který odpovídá normě ISO 8601.The "O" or "o" standard format specifier represents a custom date and time format string using a pattern that preserves time zone information and emits a result string that complies with ISO 8601. Pro DateTime hodnoty je tento specifikátor formátu navržen tak, aby zachoval hodnoty data a času spolu DateTime.Kind s vlastností v textu.For DateTime values, this format specifier is designed to preserve date and time values along with the DateTime.Kind property in text. Formátovaný řetězec lze DateTime.Parse(String, IFormatProvider, DateTimeStyles) analyzovat zpět pomocí metody nebo DateTime.ParseExact , pokud styles je parametr nastaven na DateTimeStyles.RoundtripKindhodnotu.The formatted string can be parsed back by using the DateTime.Parse(String, IFormatProvider, DateTimeStyles) or DateTime.ParseExact method if the styles parameter is set to DateTimeStyles.RoundtripKind.

Standardní specifikátor formátu "O" nebo "o" odpovídá "yyyy-yyyy '-DD 't": ' mm ': ' mm ': ' ss '. ' fffffffK "řetězec vlastního formátu pro DateTime hodnoty a" yyyy-yyyy '-DD 't ":" mm ":" SS ". fffffffzzz řetězec vlastního formátu pro DateTimeOffset hodnoty.The "O" or "o" standard format specifier corresponds to the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" custom format string for DateTime values and to the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzz" custom format string for DateTimeOffset values. Dvojice jednoduchých uvozovek v tomto řetězci oddělující jednotlivé znaky, jako jsou například spojovníky, dvojtečky a písmeno "T", označují, že jednotlivé znaky jsou literály, které nelze změnit.In this string, the pairs of single quotation marks that delimit individual characters, such as the hyphens, the colons, and the letter "T", indicate that the individual character is a literal that cannot be changed. Apostrofy se ve výstupním řetězci nezobrazují.The apostrophes do not appear in the output string.

Standardní specifikátor formátu "O" nebo "o" (a "yyyy-yyyy '-DD 't": ' mm ': ' ss '. ' fffffffK "řetězec vlastního formátu") využívá tři způsoby, které ISO 8601 představuje informace o časovém pásmu, Kind aby zachovala DateTime vlastnost hodnot:The "O" or "o" standard format specifier (and the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" custom format string) takes advantage of the three ways that ISO 8601 represents time zone information to preserve the Kind property of DateTime values:

  • Komponenta časového pásma hodnot DateTimeKind.Local data a času je posun od času UTC (například + 01:00,-07:00).The time zone component of DateTimeKind.Local date and time values is an offset from UTC (for example, +01:00, -07:00). Všechny DateTimeOffset hodnoty jsou také vyjádřeny v tomto formátu.All DateTimeOffset values are also represented in this format.

  • Komponenta časového pásma hodnot DateTimeKind.Utc data a času používá "Z" (což představuje nulový posun) k reprezentaci UTC.The time zone component of DateTimeKind.Utc date and time values uses "Z" (which stands for zero offset) to represent UTC.

  • DateTimeKind.Unspecifiedhodnoty data a času nemají žádné informace o časovém pásmu.DateTimeKind.Unspecified date and time values have no time zone information.

Vzhledem k tomu, že standardní specifikátor formátu "O" nebo "o" odpovídá mezinárodnímu standardu, operace formátování nebo analýzy, která používá specifikátor, vždy používá invariantní jazykovou verzi a gregoriánský kalendář.Because the "O" or "o" standard format specifier conforms to an international standard, the formatting or parsing operation that uses the specifier always uses the invariant culture and the Gregorian calendar.

Řetězce, které jsou předány Parsedo TryParse TryParseExact metod ParseExact DateTime ,,alzeanalyzovatpomocíspecifikátoruformátu"O"nebo"o",pokudjsouvjednomztěchtoformátů.DateTimeOffsetStrings that are passed to the Parse, TryParse, ParseExact, and TryParseExact methods of DateTime and DateTimeOffset can be parsed by using the "O" or "o" format specifier if they are in one of these formats. V případě DateTime objektů by mělo přetížení analýzy, které voláte, styles zahrnovat také DateTimeStyles.RoundtripKindparametr s hodnotou.In the case of DateTime objects, the parsing overload that you call should also include a styles parameter with a value of DateTimeStyles.RoundtripKind. Všimněte si, že pokud zavoláte metodu analýzy s vlastním řetězcem formátu, který odpovídá specifikátoru formátu "O" nebo "o", nezískáte stejné výsledky jako "O" nebo "o".Note that if you call a parsing method with the custom format string that corresponds to the "O" or "o" format specifier, you won't get the same results as "O" or "o". Důvodem je, že analýza metod, které používají řetězec vlastního formátu, nemůže analyzovat řetězcovou reprezentaci hodnot data a času, které chybí komponenty časového pásma, nebo použít "Z" k označení času UTC.This is because parsing methods that use a custom format string can't parse the string representation of date and time values that lack a time zone component or use "Z" to indicate UTC.

Následující příklad používá specifikátor formátu "o" pro zobrazení řady DateTime hodnot DateTimeOffset a hodnoty v systému v USA. Časové pásmo v Tichomoří.The following example uses the "o" format specifier to display a series of DateTime values and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

using System;

public class Example
{
   public static void Main()
   {
       DateTime dat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                   DateTimeKind.Unspecified);
       Console.WriteLine("{0} ({1}) --> {0:O}", dat, dat.Kind); 
   
       DateTime uDat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                    DateTimeKind.Utc);
       Console.WriteLine("{0} ({1}) --> {0:O}", uDat, uDat.Kind);
       
       DateTime lDat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                    DateTimeKind.Local);
       Console.WriteLine("{0} ({1}) --> {0:O}\n", lDat, lDat.Kind);
       
       DateTimeOffset dto = new DateTimeOffset(lDat);
       Console.WriteLine("{0} --> {0:O}", dto);
   }
}
// The example displays the following output:
//    6/15/2009 1:45:30 PM (Unspecified) --> 2009-06-15T13:45:30.0000000
//    6/15/2009 1:45:30 PM (Utc) --> 2009-06-15T13:45:30.0000000Z
//    6/15/2009 1:45:30 PM (Local) --> 2009-06-15T13:45:30.0000000-07:00
//    
//    6/15/2009 1:45:30 PM -07:00 --> 2009-06-15T13:45:30.0000000-07:00
Module Example
   Public Sub Main()
       Dim dat As New Date(2009, 6, 15, 13, 45, 30, 
                           DateTimeKind.Unspecified)
       Console.WriteLine("{0} ({1}) --> {0:O}", dat, dat.Kind) 
   
       Dim uDat As New Date(2009, 6, 15, 13, 45, 30, DateTimeKind.Utc)
       Console.WriteLine("{0} ({1}) --> {0:O}", uDat, uDat.Kind)
       
       Dim lDat As New Date(2009, 6, 15, 13, 45, 30, DateTimeKind.Local)
       Console.WriteLine("{0} ({1}) --> {0:O}", lDat, lDat.Kind)
       Console.WriteLine()
       
       Dim dto As New DateTimeOffset(lDat)
       Console.WriteLine("{0} --> {0:O}", dto)
   End Sub
End Module
' The example displays the following output:
'    6/15/2009 1:45:30 PM (Unspecified) --> 2009-06-15T13:45:30.0000000
'    6/15/2009 1:45:30 PM (Utc) --> 2009-06-15T13:45:30.0000000Z
'    6/15/2009 1:45:30 PM (Local) --> 2009-06-15T13:45:30.0000000-07:00
'    
'    6/15/2009 1:45:30 PM -07:00 --> 2009-06-15T13:45:30.0000000-07:00

Následující příklad používá specifikátor formátu "o" pro vytvoření formátovaného řetězce a následně obnoví původní hodnotu data a času voláním metody data a času Parse .The following example uses the "o" format specifier to create a formatted string, and then restores the original date and time value by calling a date and time Parse method.

// Round-trip DateTime values.
DateTime originalDate, newDate;
string dateString;
// Round-trip a local time.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 10, 6, 30, 0), DateTimeKind.Local);
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  newDate, newDate.Kind);
// Round-trip a UTC time.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 12, 9, 30, 0), DateTimeKind.Utc);                  
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  newDate, newDate.Kind);
// Round-trip time in an unspecified time zone.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 13, 12, 30, 0), DateTimeKind.Unspecified);                  
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  newDate, newDate.Kind);

// Round-trip a DateTimeOffset value.
DateTimeOffset originalDTO = new DateTimeOffset(2008, 4, 12, 9, 30, 0, new TimeSpan(-8, 0, 0));
dateString = originalDTO.ToString("o");
DateTimeOffset newDTO = DateTimeOffset.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} to {1}.", originalDTO, newDTO);
// The example displays the following output:
//    Round-tripped 4/10/2008 6:30:00 AM Local to 4/10/2008 6:30:00 AM Local.
//    Round-tripped 4/12/2008 9:30:00 AM Utc to 4/12/2008 9:30:00 AM Utc.
//    Round-tripped 4/13/2008 12:30:00 PM Unspecified to 4/13/2008 12:30:00 PM Unspecified.
//    Round-tripped 4/12/2008 9:30:00 AM -08:00 to 4/12/2008 9:30:00 AM -08:00.
' Round-trip DateTime values.
Dim originalDate, newDate As Date
Dim dateString As String
' Round-trip a local time.
originalDate = Date.SpecifyKind(#4/10/2008 6:30AM#, DateTimeKind.Local)
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
                  newDate, newDate.Kind)
' Round-trip a UTC time.
originalDate = Date.SpecifyKind(#4/12/2008 9:30AM#, DateTimeKind.Utc)                  
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
                  newDate, newDate.Kind)
' Round-trip time in an unspecified time zone.
originalDate = Date.SpecifyKind(#4/13/2008 12:30PM#, DateTimeKind.Unspecified)                  
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
                  newDate, newDate.Kind)

' Round-trip a DateTimeOffset value.
Dim originalDTO As New DateTimeOffset(#4/12/2008 9:30AM#, New TimeSpan(-8, 0, 0))
dateString = originalDTO.ToString("o")
Dim newDTO As DateTimeOffset = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} to {1}.", originalDTO, newDTO)
' The example displays the following output:
'    Round-tripped 4/10/2008 6:30:00 AM Local to 4/10/2008 6:30:00 AM Local.
'    Round-tripped 4/12/2008 9:30:00 AM Utc to 4/12/2008 9:30:00 AM Utc.
'    Round-tripped 4/13/2008 12:30:00 PM Unspecified to 4/13/2008 12:30:00 PM Unspecified.
'    Round-tripped 4/12/2008 9:30:00 AM -08:00 to 4/12/2008 9:30:00 AM -08:00.

Zpět na tabulkuBack to table

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

Standardní specifikátor formátu "r" nebo "r" představuje řetězec vlastního formátu data a času, který je definován DateTimeFormatInfo.RFC1123Pattern vlastností.The "R" or "r" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.RFC1123Pattern property. Tento vzor odpovídá definovanému standardu a příslušná vlastnost je určena jen pro čtení.The pattern reflects a defined standard, and the property is read-only. Proto je vždy stejný bez ohledu na použitou jazykovou verzi nebo dodaného poskytovatele formátu.Therefore, it is always the same, regardless of the culture used or the format provider supplied. Řetězec vlastního formátu je "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'".The custom format string is "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'". Při použití tohoto standardního specifikátoru formátu používá operace formátování nebo analýzy vždy neutrální jazykovou verzi.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

Výsledný řetězec je ovlivněn následujícími vlastnostmi DateTimeFormatInfo objektu vráceného DateTimeFormatInfo.InvariantInfo vlastností, která představuje invariantní jazykovou verzi.The result string is affected by the following properties of the DateTimeFormatInfo object returned by the DateTimeFormatInfo.InvariantInfo property that represents the invariant culture.

VlastnostProperty PopisDescription
RFC1123Pattern Definuje formát výsledného řetězce.Defines the format of the result string.
AbbreviatedDayNames Definuje zkrácené názvy dní, které mohou být zobrazeny ve výsledném řetězci.Defines the abbreviated day names that can appear in the result string.
AbbreviatedMonthNames Definuje zkrácené názvy měsíců, které mohou být zobrazeny ve výsledném řetězci.Defines the abbreviated month names that can appear in the result string.

I když standard RFC 1123 vyjadřuje čas jako koordinovaný světový čas (UTC), operace formátování neupraví hodnotu DateTime objektu, který se formátuje.Although the RFC 1123 standard expresses a time as Coordinated Universal Time (UTC), the formatting operation does not modify the value of the DateTime object that is being formatted. Proto je nutné převést DateTime hodnotu na čas UTC DateTime.ToUniversalTime voláním metody před provedením operace formátování.Therefore, you must convert the DateTime value to UTC by calling the DateTime.ToUniversalTime method before you perform the formatting operation. Naopak DateTimeOffset hodnoty provádějí tento převod automaticky; před operací formátování není nutné DateTimeOffset.ToUniversalTime volat metodu.In contrast, DateTimeOffset values perform this conversion automatically; there is no need to call the DateTimeOffset.ToUniversalTime method before the formatting operation.

Následující příklad používá specifikátor formátu "r" pro zobrazení DateTime DateTimeOffset a a hodnotu v systému v USA. Časové pásmo v Tichomoří.The following example uses the "r" format specifier to display a DateTime and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
DateTimeOffset dateOffset = new DateTimeOffset(date1, 
                            TimeZoneInfo.Local.GetUtcOffset(date1));
Console.WriteLine(date1.ToUniversalTime().ToString("r"));
// Displays Thu, 10 Apr 2008 13:30:00 GMT                       
Console.WriteLine(dateOffset.ToUniversalTime().ToString("r"));
// Displays Thu, 10 Apr 2008 13:30:00 GMT                        
Dim date1 As Date = #4/10/2008 6:30AM#
Dim dateOffset As New DateTimeOffset(date1, TimeZoneInfo.Local.GetUtcOFfset(date1))
Console.WriteLine(date1.ToUniversalTime.ToString("r"))
' Displays Thu, 10 Apr 2008 13:30:00 GMT                       
Console.WriteLine(dateOffset.ToUniversalTime.ToString("r"))
' Displays Thu, 10 Apr 2008 13:30:00 GMT                        

Zpět na tabulkuBack to table

Specifikátor seřaditelného formátu ("s")The Sortable ("s") Format Specifier

Standardní specifikátor formátu "s" představuje řetězec vlastního formátu data a času, který je definován DateTimeFormatInfo.SortableDateTimePattern vlastností.The "s" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.SortableDateTimePattern property. Tento vzor odpovídá definovanému standardu (ISO 8601) a příslušná vlastnost je určena jen pro čtení.The pattern reflects a defined standard (ISO 8601), and the property is read-only. Proto je vždy stejný bez ohledu na použitou jazykovou verzi nebo dodaného poskytovatele formátu.Therefore, it is always the same, regardless of the culture used or the format provider supplied. Řetězec vlastního formátu je "yyyy'-'MM'-'dd'T'HH':'mm':'ss".The custom format string is "yyyy'-'MM'-'dd'T'HH':'mm':'ss".

Účelem specifikátoru formátu "s" je vytváření výsledných řetězců, které se konzistentně řadí ve vzestupném nebo sestupném pořadí podle hodnot data a času.The purpose of the "s" format specifier is to produce result strings that sort consistently in ascending or descending order based on date and time values. V důsledku toho i když standardní specifikátor formátu "s" představuje hodnotu data a času v konzistentním formátu, operace formátování neupravuje hodnotu objektu data a času, který je formátován tak, aby odrážel jeho DateTime.Kind vlastnost nebo jeho DateTimeOffset.Offset hodnota.As a result, although the "s" standard format specifier represents a date and time value in a consistent format, the formatting operation does not modify the value of the date and time object that is being formatted to reflect its DateTime.Kind property or its DateTimeOffset.Offset value. Například výsledné řetězce vytvořené formátováním hodnot data a času 2014-11-15T18:32:17 + 00:00 a 2014-11-15T18:32:17 + 08:00 jsou identické.For example, the result strings produced by formatting the date and time values 2014-11-15T18:32:17+00:00 and 2014-11-15T18:32:17+08:00 are identical.

Při použití tohoto standardního specifikátoru formátu používá operace formátování nebo analýzy vždy neutrální jazykovou verzi.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

Následující příklad používá specifikátor formátu "s" pro zobrazení DateTime DateTimeOffset a a hodnotu v systému v USA. Časové pásmo v Tichomoří.The following example uses the "s" format specifier to display a DateTime and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("s"));
// Displays 2008-04-10T06:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("s"))
' Displays 2008-04-10T06:30:00                       

Zpět na tabulkuBack to table

Specifikátor krátkého formátu času ("t")The Short Time ("t") Format Specifier

Standardní specifikátor formátu "t" představuje řetězec vlastního formátu data a času, který je definován aktuální DateTimeFormatInfo.ShortTimePattern vlastností.The "t" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.ShortTimePattern property. Například řetězec vlastního formátu pro neutrální jazykovou verzi je "HH:mm".For example, the custom format string for the invariant culture is "HH:mm".

Výsledný řetězec je ovlivněn informacemi o formátování konkrétního DateTimeFormatInfo objektu.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. V následující tabulce jsou uvedeny DateTimeFormatInfo vlastnosti objektu, které mohou řídit formátování vráceného řetězce.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Specifikátor vlastního formátu, který je vrácen DateTimeFormatInfo.ShortTimePattern vlastností některých kultur, nemusí využívat všechny vlastnosti.The custom format specifier that is returned by the DateTimeFormatInfo.ShortTimePattern property of some cultures may not make use of all properties.

VlastnostProperty PopisDescription
ShortTimePattern Definuje formát komponenty času výsledného řetězce.Defines the format of the time component of the result string.
TimeSeparator Definuje řetězec, který odděluje komponenty hodiny, minuty a sekundy v časovém údaji.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definuje řetězec, který označuje dobu od půlnoci do doby před polednem ve 12hodinovém formátu.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definuje řetězec, který označuje dobu od poledne do doby před půlnocí ve 12hodinovém formátu.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Následující příklad používá specifikátor formátu "t" k zobrazení hodnoty data a času.The following example uses the "t" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("t", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 6:30 AM                        
Console.WriteLine(date1.ToString("t", 
                  CultureInfo.CreateSpecificCulture("es-ES")));
// Displays 6:30                      
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("t", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 6:30 AM                        
Console.WriteLine(date1.ToString("t", _
                  CultureInfo.CreateSpecificCulture("es-ES")))
' Displays 6:30                      

Zpět na tabulkuBack to table

Specifikátor dlouhého formátu času ("T")The Long Time ("T") Format Specifier

Standardní specifikátor formátu "T" představuje řetězec vlastního formátu data a času, který je definován DateTimeFormatInfo.LongTimePattern vlastností konkrétní jazykové verze.The "T" standard format specifier represents a custom date and time format string that is defined by a specific culture's DateTimeFormatInfo.LongTimePattern property. Například řetězec vlastního formátu pro neutrální jazykovou verzi je "HH:mm:ss".For example, the custom format string for the invariant culture is "HH:mm:ss".

V následující tabulce jsou uvedeny DateTimeFormatInfo vlastnosti objektu, které mohou řídit formátování vráceného řetězce.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Specifikátor vlastního formátu, který je vrácen DateTimeFormatInfo.LongTimePattern vlastností některých kultur, nemusí využívat všechny vlastnosti.The custom format specifier that is returned by the DateTimeFormatInfo.LongTimePattern property of some cultures may not make use of all properties.

VlastnostProperty PopisDescription
LongTimePattern Definuje formát komponenty času výsledného řetězce.Defines the format of the time component of the result string.
TimeSeparator Definuje řetězec, který odděluje komponenty hodiny, minuty a sekundy v časovém údaji.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definuje řetězec, který označuje dobu od půlnoci do doby před polednem ve 12hodinovém formátu.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definuje řetězec, který označuje dobu od poledne do doby před půlnocí ve 12hodinovém formátu.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Následující příklad používá specifikátor formátu "T" k zobrazení hodnoty data a času.The following example uses the "T" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("T", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 6:30:00 AM                       
Console.WriteLine(date1.ToString("T", 
                  CultureInfo.CreateSpecificCulture("es-ES")));
// Displays 6:30:00                      
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("T", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 6:30:00 AM                       
Console.WriteLine(date1.ToString("T", _
                  CultureInfo.CreateSpecificCulture("es-ES")))
' Displays 6:30:00                      

Zpět na tabulkuBack to table

Specifikátor univerzálního seřaditelného formátu ("u")The Universal Sortable ("u") Format Specifier

Standardní specifikátor formátu "u" představuje řetězec vlastního formátu data a času, který je definován DateTimeFormatInfo.UniversalSortableDateTimePattern vlastností.The "u" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.UniversalSortableDateTimePattern property. Tento vzor odpovídá definovanému standardu a příslušná vlastnost je určena jen pro čtení.The pattern reflects a defined standard, and the property is read-only. Proto je vždy stejný bez ohledu na použitou jazykovou verzi nebo dodaného poskytovatele formátu.Therefore, it is always the same, regardless of the culture used or the format provider supplied. Řetězec vlastního formátu je "yyyy'-'MM'-'dd HH':'mm':'ss'Z'".The custom format string is "yyyy'-'MM'-'dd HH':'mm':'ss'Z'". Při použití tohoto standardního specifikátoru formátu používá operace formátování nebo analýzy vždy neutrální jazykovou verzi.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

I když by výsledný řetězec měl vyjadřovat čas koordinovaný světový čas (UTC), během operace formátování se neprovede DateTime žádný převod původní hodnoty.Although the result string should express a time as Coordinated Universal Time (UTC), no conversion of the original DateTime value is performed during the formatting operation. Proto je nutné převést DateTime hodnotu na čas UTC DateTime.ToUniversalTime voláním metody před formátováním.Therefore, you must convert a DateTime value to UTC by calling the DateTime.ToUniversalTime method before formatting it. Naopak DateTimeOffset hodnoty provádějí tento převod automaticky; před operací formátování není nutné DateTimeOffset.ToUniversalTime volat metodu.In contrast, DateTimeOffset values perform this conversion automatically; there is no need to call the DateTimeOffset.ToUniversalTime method before the formatting operation.

Následující příklad používá specifikátor formátu "u" k zobrazení hodnoty data a času.The following example uses the "u" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToUniversalTime().ToString("u"));
// Displays 2008-04-10 13:30:00Z                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToUniversalTime.ToString("u"))
' Displays 2008-04-10 13:30:00Z                       

Zpět na tabulkuBack to table

Specifikátor univerzálního úplného formátu ("U")The Universal Full ("U") Format Specifier

Standardní specifikátor formátu "U" představuje řetězec vlastního formátu data a času, který je definován zadanou DateTimeFormatInfo.FullDateTimePattern vlastností jazykové verze.The "U" standard format specifier represents a custom date and time format string that is defined by a specified culture's DateTimeFormatInfo.FullDateTimePattern property. Tento vzor je stejný jako vzor "F".The pattern is the same as the "F" pattern. DateTime Hodnota je však automaticky převedena na UTC před formátováním.However, the DateTime value is automatically converted to UTC before it is formatted.

V následující tabulce jsou uvedeny DateTimeFormatInfo vlastnosti objektu, které mohou řídit formátování vráceného řetězce.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Specifikátor vlastního formátu, který je vrácen FullDateTimePattern vlastností některých kultur, nemusí využívat všechny vlastnosti.The custom format specifier that is returned by the FullDateTimePattern property of some cultures may not make use of all properties.

VlastnostProperty PopisDescription
FullDateTimePattern Definuje celkový formát výsledného řetězce.Defines the overall format of the result string.
DayNames Definuje lokalizované názvy dní, které mohou být zobrazeny ve výsledném řetězci.Defines the localized day names that can appear in the result string.
MonthNames Definuje lokalizované názvy měsíců, které mohou být zobrazeny ve výsledném řetězci.Defines the localized month names that can appear in the result string.
TimeSeparator Definuje řetězec, který odděluje komponenty hodiny, minuty a sekundy v časovém údaji.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Definuje řetězec, který označuje dobu od půlnoci do doby před polednem ve 12hodinovém formátu.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Definuje řetězec, který označuje dobu od poledne do doby před půlnocí ve 12hodinovém formátu.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Specifikátor formátu "U" není tímto DateTimeOffset typem podporován a FormatException vyvolá výjimku, pokud DateTimeOffset je použita k formátování hodnoty.The "U" format specifier is not supported by the DateTimeOffset type and throws a FormatException if it is used to format a DateTimeOffset value.

Následující příklad používá specifikátor formátu "U" k zobrazení hodnoty data a času.The following example uses the "U" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("U", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 1:30:00 PM                       
Console.WriteLine(date1.ToString("U", 
                  CultureInfo.CreateSpecificCulture("sv-FI")));
// Displays den 10 april 2008 13:30:00                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("U", CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 1:30:00 PM                       
Console.WriteLine(date1.ToString("U", CultureInfo.CreateSpecificCulture("sv-FI")))
' Displays den 10 april 2008 13:30:00                       

Zpět na tabulkuBack to table

Specifikátor formátu roku a měsíce ("Y", "y")The Year Month ("Y", "y") Format Specifier

Standardní specifikátor formátu "Y" nebo "y" představuje řetězec vlastního formátu data a času, který je definován DateTimeFormatInfo.YearMonthPattern vlastností zadané jazykové verze.The "Y" or "y" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.YearMonthPattern property of a specified culture. Například řetězec vlastního formátu pro neutrální jazykovou verzi je "yyyy MMMM".For example, the custom format string for the invariant culture is "yyyy MMMM".

V následující tabulce jsou uvedeny DateTimeFormatInfo vlastnosti objektu, které řídí formátování vráceného řetězce.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

VlastnostProperty PopisDescription
YearMonthPattern Definuje celkový formát výsledného řetězce.Defines the overall format of the result string.
MonthNames Definuje lokalizované názvy měsíců, které mohou být zobrazeny ve výsledném řetězci.Defines the localized month names that can appear in the result string.

Následující příklad používá specifikátor formátu "y" k zobrazení hodnoty data a času.The following example uses the "y" format specifier to display a date and time value.

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("Y", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays April, 2008                       
Console.WriteLine(date1.ToString("y", 
                  CultureInfo.CreateSpecificCulture("af-ZA")));
// Displays April 2008                       
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("Y", CultureInfo.CreateSpecificCulture("en-US")))
' Displays April, 2008                       
Console.WriteLine(date1.ToString("y", CultureInfo.CreateSpecificCulture("af-ZA")))
' Displays April 2008                       

Zpět na tabulkuBack to table

PoznámkyNotes

Nastavení části Ovládací panelyControl Panel Settings

Nastavení v položce místní a jazykové nastavení v Ovládacích panelech ovlivní výsledný řetězec vytvořený při operaci formátování.The settings in the Regional and Language Options item in Control Panel influence the result string produced by a formatting operation. Tato nastavení slouží k inicializaci DateTimeFormatInfo objektu přidruženého k aktuální jazykové verzi vlákna, které poskytuje hodnoty použité k řízení formátování.These settings are used to initialize the DateTimeFormatInfo object associated with the current thread culture, which provides values used to govern formatting. Počítače, které používají různá nastavení, generují různé výsledné řetězce.Computers that use different settings generate different result strings.

Kromě toho, pokud použijete CultureInfo.CultureInfo(String) konstruktor k vytvoření instance nového CultureInfo objektu, který představuje stejnou jazykovou verzi jako aktuální jazyková verze systému, jakákoli vlastní nastavení, která byla vytvořena položkou místní a jazykové nastavení v Ovládacích panelech bude použito pro nový CultureInfo objekt.In addition, if you use the CultureInfo.CultureInfo(String) constructor to instantiate a new CultureInfo object that represents the same culture as the current system culture, any customizations established by the Regional and Language Options item in Control Panel will be applied to the new CultureInfo object. CultureInfo.CultureInfo(String, Boolean) Konstruktor můžete použít k CultureInfo vytvoření objektu, který nereflektuje vlastní nastavení systému.You can use the CultureInfo.CultureInfo(String, Boolean) constructor to create a CultureInfo object that does not reflect a system's customizations.

Vlastnosti DateTimeFormatInfoDateTimeFormatInfo Properties

Formátování je ovlivněno vlastnostmi aktuálního DateTimeFormatInfo objektu, který je poskytnut implicitně aktuální jazykovou verzí vlákna nebo explicitně IFormatProvider parametrem metody, která vyvolá formátování.Formatting is influenced by properties of the current DateTimeFormatInfo object, which is provided implicitly by the current thread culture or explicitly by the IFormatProvider parameter of the method that invokes formatting. Pro parametr by měla vaše aplikace CultureInfo určovat objekt, který představuje jazykovou verzi, nebo DateTimeFormatInfo objekt, který představuje konvence formátování data a času konkrétní jazykové verze. IFormatProviderFor the IFormatProvider parameter, your application should specify a CultureInfo object, which represents a culture, or a DateTimeFormatInfo object, which represents a particular culture's date and time formatting conventions. Mnohé standardní specifikátory formátu data a času jsou aliasy pro vzory formátování definované vlastnostmi aktuálního DateTimeFormatInfo objektu.Many of the standard date and time format specifiers are aliases for formatting patterns defined by properties of the current DateTimeFormatInfo object. Vaše aplikace může změnit výsledek vytvořený některými specifikátory standardního formátu data a času změnou odpovídajících vzorů formátu data a času odpovídající DateTimeFormatInfo vlastnosti.Your application can change the result produced by some standard date and time format specifiers by changing the corresponding date and time format patterns of the corresponding DateTimeFormatInfo property.

Viz také:See also