Standardowe ciągi formatujące datę i godzinęStandard Date and Time Format Strings

W ciągu standardowego formatu daty i godziny pojedynczy specyfikator formatu jest używany do definiowania tekstowej reprezentacji wartości daty i godziny.A standard date and time format string uses a single format specifier to define the text representation of a date and time value. Ciągu formatu daty i godziny, który zawiera więcej niż jeden znak, w tym znak odstępu, jest interpretowany jako niestandardowy ciąg daty i godziny formatu; Aby uzyskać więcej informacji, zobacz Custom Date and Time Format Strings.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. Ciągu formatu standardowego lub niestandardowego można używać na dwa sposoby:A standard or custom format string can be used in two ways:

  • Aby zdefiniować ciąg będący wynikiem operacji formatowania.To define the string that results from a formatting operation.

  • Aby zdefiniować tekstową reprezentację wartości daty i godziny, który może zostać przekonwertowany na DateTime lub DateTimeOffset wartości podczas operacji analizy.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.

Porada

Możesz pobrać narzędzie do formatowania, aplikację, która umożliwia zastosowanie formatu ciągów liczbowego lub daty i godziny, wartości oraz wyświetlenie ciągu wynikowego.You can download the Formatting Utility, an application that enables you to apply format strings to either numeric or date and time values and displays the result string.

Standardowy format daty i ciągi formatu czasu mogą być używane z obu DateTime i DateTimeOffset wartości.Standard date and time format strings can be used with both DateTime and DateTimeOffset values.

Uwaga

The C# examples in this article run in the Try.NET inline code runner and playground. Select the Run button to run an example in an interactive window. Once you execute the code, you can modify it and run the modified code by selecting Run again. The modified code either runs in the interactive window or, if compilation fails, the interactive window displays all C# compiler error messages.

The local time zone of the Try.NET inline code runner and playground is Coordinated Universal Time, or UTC. This may affect the behavior and the output of examples that illustrate the DateTime, DateTimeOffset, and TimeZoneInfo types and their members.

W poniższej tabeli opisano standardowy format daty i czasu specyfikatorów formatu.The following table describes the standard date and time format specifiers. Jeśli nie określono inaczej, określonego standardowy daty i czas formatowania specyfikator wytwarza identyczną reprezentację ciągu niezależnie od tego, czy jest użyty z DateTime lub DateTimeOffset wartość.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. Zobacz uwagi sekcji, aby uzyskać dodatkowe informacje na temat przy użyciu standardowych ciągów daty i godziny formatu.See the Notes section for additional information about using standard date and time format strings.

Specyfikator formatuFormat specifier OpisDescription PrzykładyExamples
„d”"d" Wzorzec daty krótkiej.Short date pattern.

Więcej informacji:daty krótkiej ("d") specyfikator formatu.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 -> 06-15/2009 (fr-FR)2009-06-15T13:45:30 -> 15/06/2009 (fr-FR)

2009-06-15T13:45:30 -> 06-2009-15 (ja-JP)2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
„D”"D" Wzorzec daty długiej.Long date pattern.

Więcej informacji:specyfikator formatu daty długiej ("D").More information:The Long Date ("D") Format Specifier.
2009-06-15T13:45:30 -> poniedziałek, czerwiec 15, 2009 (en US)2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)

2009-06-15T13:45:30 -> 15 г июня 2009 r.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" Wzorzec pełnej daty/godziny (godzina krótka).Full date/time pattern (short time).

Więcej informacji: pełnej daty i godziny krótkiej ("f") specyfikator formatu.More information: The Full Date Short Time ("f") Format Specifier.
2009-06-15T13:45:30 -> poniedziałek, czerwiec 15, 2009 1:45 PM (en US)2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US)

2009-06-15T13:45:30 -> juni den 15, 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" Wzorzec pełnej daty/godziny (godzina długa).Full date/time pattern (long time).

Więcej informacji: specyfikator formatu pełnej daty i godziny długiej ("F").More information: The Full Date Long Time ("F") Format Specifier.
2009-06-15T13:45:30 -> poniedziałek, czerwiec 15, 2009 1:45:30 PM (en US)2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US)

2009-06-15T13:45:30 -> juni den 15, 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" Wzorzec ogólnej daty/godziny (godzina krótka).General date/time pattern (short time).

Więcej informacji: ogólne daty i godziny krótkiej ("g") specyfikator formatu.More information: The General Date Short Time ("g") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en US)2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US)

2009-06-06-15/2009-> 15T13:45:30 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" Wzorzec ogólnej daty/godziny (godzina długa).General date/time pattern (long time).

Więcej informacji: specyfikator formatu ogólnego daty i godziny długiej ("G").More information: The General Date Long Time ("G") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en US)2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US)

2009-06-15T13:45:30 -> 06-15/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" Wzorzec miesiąc/dzień.Month/day pattern.

Więcej informacji: specyfikator formatu miesiąca ("M", "m").More information: The Month ("M", "m") Format Specifier.
2009-06-15T13:45:30 -> 15 czerwca (pl pl)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 -> Juni 15 (identyfikator ID)2009-06-15T13:45:30 -> 15 Juni (id-ID)
„O”, „o”"O", "o" Wzorzec dwustronnej konwersji data/godzina.Round-trip date/time pattern.

Więcej informacji: specyfikator formatu dwustronnej konwersji ("O", "o").More information: The Round-trip ("O", "o") Format Specifier.
DateTime Wartości:DateTime 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.0000000Z2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z

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

DateTimeOffset Wartości:DateTimeOffset 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" Wzorzec RFC1123.RFC1123 pattern.

Więcej informacji: RFC1123 ("R", "r") specyfikator formatu.More information: The RFC1123 ("R", "r") Format Specifier.
2009-06-15T13:45:30 -> pon, 15 cze 2009 20:45:30 GMT2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT
„s”"s" Wzorzec sortowalnej daty/godziny.Sortable date/time pattern.

Więcej informacji: sortowalnego ("s") specyfikator formatu.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" Wzorzec godziny krótkiej.Short time pattern.

Więcej informacji: godziny krótkiej ("t") specyfikator formatu.More information: The Short Time ("t") Format Specifier.
2009-06-15T13:45:30 -> 1:45 PM (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 — na przykład)2009-06-15T13:45:30 -> 01:45 م (ar-EG)
„T”"T" Wzorzec godziny długiej.Long time pattern.

Więcej informacji: specyfikator formatu godziny długiej ("T").More information: The Long Time ("T") Format Specifier.
2009-06-15T13:45:30 -> 1:45:30 PM (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 — na przykład)2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
„u”"u" Wzorzec uniwersalnej sortowalnej daty/godziny.Universal sortable date/time pattern.

Więcej informacji: specyfikator uniwersalnego sortowalnego ("u") specyfikator formatu.More information: The Universal Sortable ("u") Format Specifier.
Za pomocą DateTime wartość: 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

Za pomocą DateTimeOffset wartość: 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" Wzorzec uniwersalnej pełnej daty/godziny.Universal full date/time pattern.

Więcej informacji: specyfikator uniwersalnego pełnego ("U") formatu.More information: The Universal Full ("U") Format Specifier.
2009-06-15T13:45:30 -> poniedziałek, czerwiec 15, 2009 8:45:30 PM (en US)2009-06-15T13:45:30 -> Monday, June 15, 2009 8:45:30 PM (en-US)

2009-06-15T13:45:30 -> juni den 15, 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" Wzorzec roku i miesiąca.Year month pattern.

Więcej informacji: specyfikator formatu roku i miesiąca ("Y").More information: The Year Month ("Y") Format Specifier.
2009-06-15T13:45:30 -> 2009 czerwca (pl pl)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 -> 2009 Juni (identyfikator ID)2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Jakikolwiek inny pojedynczy znakAny other single character Nieznany specyfikator.Unknown specifier. Zgłasza wyjątek czasu wykonywania FormatException.Throws a run-time FormatException.

Sposób działania ciągów formatu standardowegoHow Standard Format Strings Work

W operacji formatowania ciąg formatu standardowego jest po prostu aliasem ciągu formatu niestandardowego.In a formatting operation, a standard format string is simply an alias for a custom format string. Zaletą użycia aliasu w celu odwołania się do ciągu formatu niestandardowego jest to, że ciąg formatu niestandardowego może być różny, mimo że alias pozostaje niezmienny.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. Jest to ważne, ponieważ ciągi reprezentujące wartości daty i godziny są zazwyczaj różne w zależności od kultury.This is important because the string representations of date and time values typically vary by culture. Na przykład ciąg formatu standardowego „d” wskazuje, że wartość daty i godziny zostanie wyświetlona przy użyciu wzorca daty krótkiej.For example, the "d" standard format string indicates that a date and time value is to be displayed using a short date pattern. Ten wzorzec dla niezmiennej kultury to „MM/dd/yyyy”.For the invariant culture, this pattern is "MM/dd/yyyy". Dla kultury fr-FR jest to „dd/MM/yyyy”.For the fr-FR culture, it is "dd/MM/yyyy". Dla kultury ja-JP jest to „yyyy/MM/dd”.For the ja-JP culture, it is "yyyy/MM/dd".

Jeśli ciąg formatu standardowego w operacji formatowania jest mapowany na ciąg formatu niestandardowego danej kultury, aplikacja może definiować określoną kulturę, której ciągi formatu niestandardowego są używane na jeden z poniższych sposobów: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:

  • Można użyć domyślnej (bieżącej) kultury.You can use the default (or current) culture. W poniższym przykładzie data jest wyświetlana przy użyciu formatu daty krótkiej dla bieżącej kultury.The following example displays a date using the current culture's short date format. Bieżącą kulturą jest w tym przypadku kultura 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
    
  • Możesz przekazać CultureInfo obiekt reprezentujący kulturę, której formatowanie ma być używany do metody, która ma IFormatProvider parametru.You can pass a CultureInfo object representing the culture whose formatting is to be used to a method that has an IFormatProvider parameter. W poniższym przykładzie data jest wyświetlana przy użyciu formatu daty krótkiej dla kultury 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
    
  • Możesz przekazać DateTimeFormatInfo obiekt, który dostarcza informacje o formatowaniu do metody, która ma IFormatProvider parametru.You can pass a DateTimeFormatInfo object that provides formatting information to a method that has an IFormatProvider parameter. Poniższy przykład wyświetla datę przy użyciu formatu daty krótkiej z DateTimeFormatInfo obiektu dla kultury 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
    

Uwaga

Aby uzyskać informacje dotyczące dostosowywania wzorców lub ciągów używanych w formatowaniu wartości daty i godziny, zobacz NumberFormatInfo temat poświęcony klasie.For information about customizing the patterns or strings used in formatting date and time values, see the NumberFormatInfo class topic.

W niektórych przypadkach ciąg formatu standardowego służy jako wygodny skrót dla dłuższego ciągu formatu niestandardowego, który jest niezmienny.In some cases, the standard format string serves as a convenient abbreviation for a longer custom format string that is invariant. Cztery ciągi formatu standardowego należą do tej kategorii: „O” (lub „o”), „R” (lub „r”), „s” i „u”.Four standard format strings fall into this category: "O" (or "o"), "R" (or "r"), "s", and "u". Te ciągi odpowiadają ciągom formatów niestandardowych, które są zdefiniowane przez niezmienną kulturę.These strings correspond to custom format strings defined by the invariant culture. Wytwarzają one reprezentacje wartości daty i godziny w postaci ciągu, które mają być identyczne dla różnych kultur.They produce string representations of date and time values that are intended to be identical across cultures. W poniższej tabeli przedstawiono informacje dotyczące tych czterech ciągów standardowych formatów daty i godziny.The following table provides information on these four standard date and time format strings.

Ciąg formatu standardowegoStandard format string Definiowany przez właściwość DateTimeFormatInfo.InvariantInfoDefined by DateTimeFormatInfo.InvariantInfo property Ciąg formatu niestandardowegoCustom format string
„O” lub „o”"O" or "o" BrakNone yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzyyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzz
„R” lub „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'

Ciągi w standardowym formacie można również w operacji analizowania za pomocą DateTime.ParseExact lub DateTimeOffset.ParseExact metody, które wymagają ciąg wejściowy dokładnie odpowiada wzorcowi jako warunek powodzenia operacji analizy.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. Wiele ciągów formatów standardowych jest mapowanych na wielu ciągów formatów niestandardowych, więc wartość daty i godziny może być reprezentowana przez wiele formatów, a operacja analizy i tak zakończy się powodzeniem.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. Należy określić ciąg formatu niestandardowego lub ciągów, które odpowiadają ciągowi formatu standardowego, wywołując 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. W poniższym przykładzie są wyświetlane ciągi formatów niestandardowych mapowane na ciąg formatu standardowego „d” (wzorzec daty krótkiej).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

W poniższych sekcjach opisano specyfikatory formatu standardowego dla DateTime i DateTimeOffset wartości.The following sections describe the standard format specifiers for DateTime and DateTimeOffset values.

Specyfikator formatu daty krótkiej („d”)The Short Date ("d") Format Specifier

Specyfikator formatu standardowego "d" reprezentuje niestandardowa data i godzina ciąg formatu, który jest definiowany przez określoną kulturę DateTimeFormatInfo.ShortDatePattern właściwości.The "d" standard format specifier represents a custom date and time format string that is defined by a specific culture's DateTimeFormatInfo.ShortDatePattern property. Na przykład ciąg formatu niestandardowego, który jest zwracany przez ShortDatePattern właściwości niezmiennej kultury to "MM/dd/yyyy".For example, the custom format string that is returned by the ShortDatePattern property of the invariant culture is "MM/dd/yyyy".

W poniższej tabeli wymieniono DateTimeFormatInfo obiektu właściwości, które sterują formatowaniem zwracanego ciągu.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

WłaściwośćProperty OpisDescription
ShortDatePattern Definiuje ogólny format ciągu wynikowego.Defines the overall format of the result string.
DateSeparator Określa ciąg, który oddziela składniki daty: rok, miesiąc i dzień.Defines the string that separates the year, month, and day components of a date.

W poniższym przykładzie użyto specyfikatora formatu „d”, aby wyświetlić wartość daty i godziny.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                       

Powrót do tabeliBack to table

Specyfikator formatu daty długiej („D”)The Long Date ("D") Format Specifier

Specyfikator formatu standardowego "D" reprezentuje niestandardowa data i godzina ciąg formatu, który jest definiowany przez bieżącą DateTimeFormatInfo.LongDatePattern właściwości.The "D" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.LongDatePattern property. Na przykład ciąg formatu niestandardowego dla niezmiennej kultury to „dddd, dd MMMM yyyy”.For example, the custom format string for the invariant culture is "dddd, dd MMMM yyyy".

Poniższa tabela zawiera listę właściwości DateTimeFormatInfo obiektów, które sterują formatowaniem zwracanego ciągu.The following table lists the properties of the DateTimeFormatInfo object that control the formatting of the returned string.

WłaściwośćProperty OpisDescription
LongDatePattern Definiuje ogólny format ciągu wynikowego.Defines the overall format of the result string.
DayNames Definiuje zlokalizowane nazwy dni, które mogą być wyświetlane w ciągu wynikowym.Defines the localized day names that can appear in the result string.
MonthNames Definiuje zlokalizowane nazwy miesięcy, które mogą być wyświetlane w ciągu wynikowym.Defines the localized month names that can appear in the result string.

W poniższym przykładzie użyto specyfikatora formatu „D”, aby wyświetlić wartość daty i godziny.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                        

Powrót do tabeliBack to table

Specyfikator formatu pełnej daty i godziny krótkiej („f”)The Full Date Short Time ("f") Format Specifier

Specyfikator formatu standardowego „f” reprezentuje kombinację wzorców daty długiej („D”) i godziny krótkiej („t”), rozdzielonych spacją.The "f" standard format specifier represents a combination of the long date ("D") and short time ("t") patterns, separated by a space.

Ciąg wynikowy mają wpływ informacje o formatowaniu określonego DateTimeFormatInfo obiektu.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. W poniższej tabeli wymieniono DateTimeFormatInfo obiektu właściwości, które mogą sterować formatowaniem zwracanego ciągu.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Specyfikator formatu niestandardowego zwracany przez DateTimeFormatInfo.LongDatePattern i DateTimeFormatInfo.ShortTimePattern właściwości niektórych kultur może nie mieć używać wszystkich właściwości.The custom format specifier returned by the DateTimeFormatInfo.LongDatePattern and DateTimeFormatInfo.ShortTimePattern properties of some cultures may not make use of all properties.

WłaściwośćProperty OpisDescription
LongDatePattern Definiuje format składnika daty w ciągu wynikowym.Defines the format of the date component of the result string.
ShortTimePattern Definiuje format składnika godziny w ciągu wynikowym.Defines the format of the time component of the result string.
DayNames Definiuje zlokalizowane nazwy dni, które mogą być wyświetlane w ciągu wynikowym.Defines the localized day names that can appear in the result string.
MonthNames Definiuje zlokalizowane nazwy miesięcy, które mogą być wyświetlane w ciągu wynikowym.Defines the localized month names that can appear in the result string.
TimeSeparator Definiuje ciąg, który rozdziela składniki godziny, minuty i sekundy w ciągu reprezentującym godzinę.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Określa ciąg, który wskazuje czas od północy do południa (z wyłączeniem południa), w formacie 12-godzinnym.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Określa ciąg, który wskazuje czas od południa do północy (z wyłączeniem północy), w formacie 12-godzinnym.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

W poniższym przykładzie użyto specyfikatora formatu „f”, aby wyświetlić wartość daty i godziny.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                       

Powrót do tabeliBack to table

Specyfikator formatu pełnej daty i godziny długiej („F”)The Full Date Long Time ("F") Format Specifier

Specyfikator formatu standardowego "F" reprezentuje niestandardowa data i godzina ciąg formatu, który jest definiowany przez bieżącą DateTimeFormatInfo.FullDateTimePattern właściwości.The "F" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.FullDateTimePattern property. Na przykład ciąg formatu niestandardowego dla niezmiennej kultury to „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".

W poniższej tabeli wymieniono DateTimeFormatInfo obiektu właściwości, które mogą sterować formatowaniem zwracanego ciągu.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Specyfikator formatu niestandardowego, który jest zwracany przez FullDateTimePattern właściwość niektórych kultur może nie mieć używać wszystkich właściwości.The custom format specifier that is returned by the FullDateTimePattern property of some cultures may not make use of all properties.

WłaściwośćProperty OpisDescription
FullDateTimePattern Definiuje ogólny format ciągu wynikowego.Defines the overall format of the result string.
DayNames Definiuje zlokalizowane nazwy dni, które mogą być wyświetlane w ciągu wynikowym.Defines the localized day names that can appear in the result string.
MonthNames Definiuje zlokalizowane nazwy miesięcy, które mogą być wyświetlane w ciągu wynikowym.Defines the localized month names that can appear in the result string.
TimeSeparator Definiuje ciąg, który rozdziela składniki godziny, minuty i sekundy w ciągu reprezentującym godzinę.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Określa ciąg, który wskazuje czas od północy do południa (z wyłączeniem południa), w formacie 12-godzinnym.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Określa ciąg, który wskazuje czas od południa do północy (z wyłączeniem północy), w formacie 12-godzinnym.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

W poniższym przykładzie użyto specyfikatora formatu „F”, aby wyświetlić wartość daty i godziny.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                       

Powrót do tabeliBack to table

Specyfikator formatu daty ogólnej i godziny krótkiej („g”)The General Date Short Time ("g") Format Specifier

Specyfikator formatu standardowego „g” reprezentuje kombinację wzorców daty krótkiej („g”) i godziny krótkiej („t”), rozdzielonych spacją.The "g" standard format specifier represents a combination of the short date ("d") and short time ("t") patterns, separated by a space.

Ciąg wynikowy mają wpływ informacje o formatowaniu określonego DateTimeFormatInfo obiektu.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. W poniższej tabeli wymieniono DateTimeFormatInfo obiektu właściwości, które mogą sterować formatowaniem zwracanego ciągu.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Specyfikator formatu niestandardowego, który jest zwracany przez DateTimeFormatInfo.ShortDatePattern i DateTimeFormatInfo.ShortTimePattern właściwości niektórych kultur może nie mieć używać wszystkich właściwości.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.

WłaściwośćProperty OpisDescription
ShortDatePattern Definiuje format składnika daty w ciągu wynikowym.Defines the format of the date component of the result string.
ShortTimePattern Definiuje format składnika godziny w ciągu wynikowym.Defines the format of the time component of the result string.
DateSeparator Określa ciąg, który oddziela składniki daty: rok, miesiąc i dzień.Defines the string that separates the year, month, and day components of a date.
TimeSeparator Definiuje ciąg, który rozdziela składniki godziny, minuty i sekundy w ciągu reprezentującym godzinę.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Określa ciąg, który wskazuje czas od północy do południa (z wyłączeniem południa), w formacie 12-godzinnym.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Określa ciąg, który wskazuje czas od południa do północy (z wyłączeniem północy), w formacie 12-godzinnym.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

W poniższym przykładzie użyto specyfikatora formatu „g”, aby wyświetlić wartość daty i godziny.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                        

Powrót do tabeliBack to table

Specyfikator formatu daty ogólnej i godziny długiej („G”)The General Date Long Time ("G") Format Specifier

Specyfikator formatu standardowego „G” reprezentuje kombinację wzorców daty krótkiej („d”) i godziny długiej („T”), rozdzielonych spacją.The "G" standard format specifier represents a combination of the short date ("d") and long time ("T") patterns, separated by a space.

Ciąg wynikowy mają wpływ informacje o formatowaniu określonego DateTimeFormatInfo obiektu.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. W poniższej tabeli wymieniono DateTimeFormatInfo obiektu właściwości, które mogą sterować formatowaniem zwracanego ciągu.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Specyfikator formatu niestandardowego, który jest zwracany przez DateTimeFormatInfo.ShortDatePattern i DateTimeFormatInfo.LongTimePattern właściwości niektórych kultur może nie mieć używać wszystkich właściwości.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.

WłaściwośćProperty OpisDescription
ShortDatePattern Definiuje format składnika daty w ciągu wynikowym.Defines the format of the date component of the result string.
LongTimePattern Definiuje format składnika godziny w ciągu wynikowym.Defines the format of the time component of the result string.
DateSeparator Określa ciąg, który oddziela składniki daty: rok, miesiąc i dzień.Defines the string that separates the year, month, and day components of a date.
TimeSeparator Definiuje ciąg, który rozdziela składniki godziny, minuty i sekundy w ciągu reprezentującym godzinę.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Określa ciąg, który wskazuje czas od północy do południa (z wyłączeniem południa), w formacie 12-godzinnym.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Określa ciąg, który wskazuje czas od południa do północy (z wyłączeniem północy), w formacie 12-godzinnym.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

W poniższym przykładzie użyto specyfikatora formatu „G”, aby wyświetlić wartość daty i godziny.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                       

Powrót do tabeliBack to table

Specyfikator formatu miesiąca („M”, „m”)The Month ("M", "m") Format Specifier

Specyfikator formatu standardowego "M" lub "m" przedstawia niestandardowa data i godzina ciąg formatu, który jest definiowany przez bieżącą DateTimeFormatInfo.MonthDayPattern właściwości.The "M" or "m" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.MonthDayPattern property. Na przykład ciąg formatu niestandardowego dla niezmiennej kultury to „MMMM dd”.For example, the custom format string for the invariant culture is "MMMM dd".

W poniższej tabeli wymieniono DateTimeFormatInfo obiektu właściwości, które sterują formatowaniem zwracanego ciągu.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

WłaściwośćProperty OpisDescription
MonthDayPattern Definiuje ogólny format ciągu wynikowego.Defines the overall format of the result string.
MonthNames Definiuje zlokalizowane nazwy miesięcy, które mogą być wyświetlane w ciągu wynikowym.Defines the localized month names that can appear in the result string.

W poniższym przykładzie użyto specyfikatora formatu „m”, aby wyświetlić wartość daty i godziny.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                       

Powrót do tabeliBack to table

Specyfikator formatu dwustronnej konwersji („O”, „o”)The Round-trip ("O", "o") Format Specifier

Specyfikator formatu standardowego "O" lub "o" reprezentuje niestandardowa data i ciąg formatu godziny przy użyciu wzorca, który zachowuje informacje o strefie czasowej i emituje ciąg wynikowy, który jest zgodny z 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. Aby uzyskać DateTime wartości, ten specyfikator formatu służy do zachowania wartości daty i godziny wraz z DateTime.Kind właściwość w tekście.For DateTime values, this format specifier is designed to preserve date and time values along with the DateTime.Kind property in text. Sformatowany ciąg można analizować wstecznie, używając DateTime.Parse(String, IFormatProvider, DateTimeStyles) lub DateTime.ParseExact metoda Jeśli styles parametr ma wartość DateTimeStyles.RoundtripKind.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.

Specyfikator formatu standardowego "O" lub "o" odpowiada to "yyyy '-' MM'-'dd'T' HH': 'mm':'ss '." Ciąg formatu niestandardowego fffffffK"dla DateTime wartości i" yyyy '-' MM'-'dd'T' HH': 'mm':'ss '. " Ciąg formatu niestandardowego fffffffzzz"dla DateTimeOffset wartości.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. W tym ciągu pary znaków apostrofu, które oddzielają pojedyncze znaki, takie jak łączniki, dwukropki i litera „T”, wskazują, że indywidualny znak jest literałem, który nie może być zmieniony.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 nie znajdują się w ciągu wyjściowym.The apostrophes do not appear in the output string.

Specyfikator formatu standardowego "O" lub "o" (oraz "yyyy '-' MM'-'dd'T' HH': 'mm':'ss '." Ciąg formatu niestandardowego fffffffK") korzysta z trzech sposobów, które ISO 8601 reprezentuje informacje o strefie czasowej, aby zachować Kind właściwość DateTime wartości: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:

  • Składnik strefy czasowej DateTimeKind.Local wartości daty i godziny jest przesunięta względem czasu UTC (na przykład +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). Wszystkie DateTimeOffset wartości również są przedstawiane w tym formacie.All DateTimeOffset values are also represented in this format.

  • Składnik strefy czasowej DateTimeKind.Utc korzysta z wartości daty i godziny "Z" (która zawiera zero przesunięcie) do reprezentowania UTC.The time zone component of DateTimeKind.Utc date and time values uses "Z" (which stands for zero offset) to represent UTC.

  • DateTimeKind.Unspecified wartości daty i godziny nie ma żadnych informacji o strefie czasowej.DateTimeKind.Unspecified date and time values have no time zone information.

Ponieważ O "lub specyfikator formatu standardowego"o", który jest zgodny ze standardem międzynarodowym, formatowania lub analizowania operacji, która używa specyfikator zawsze jest używana Niezmienna kultura i kalendarz gregoriański.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.

Ciągi, które są przekazywane do Parse, TryParse, ParseExact, i TryParseExact metody DateTime i DateTimeOffset można analizować za pomocą specyfikatora formatu "O" lub "o", jeśli są one w jednym z tych formatów.Strings 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. W przypadku właściwości DateTime obiektów, analizy składni przeciążenia, które wywołujesz powinny również obejmować styles parametru z wartością DateTimeStyles.RoundtripKind.In the case of DateTime objects, the parsing overload that you call should also include a styles parameter with a value of DateTimeStyles.RoundtripKind. Należy pamiętać, że jeśli wywołujesz metodę analizy przy użyciu ciągu formatu niestandardowego, który odpowiada "O" lub "o" specyfikatora formatu, nie będą otrzymywać te same wyniki "O" lub "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". Jest to spowodowane analizowania metody, które używają ciągu formatu niestandardowego nie można przeanalizować reprezentację wartości daty i godziny, które nie ma składnika strefy czasowej, lub użyj "Z", aby wskazać 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.

W poniższym przykładzie użyto specyfikatora formatu "o", aby wyświetlić szereg DateTime wartości i DateTimeOffset wartość w systemie, w Stanach Zjednoczonych Strefa czasowa czasu pacyficznego.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

Poniższy przykład używa specyfikatora formatu "o", aby utworzyć sformatowany ciąg, a następnie przywrócenie oryginalnej wartości daty i godziny przez wywołanie datę i godzinę Parse metody.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.

Powrót do tabeliBack to table

Specyfikator formatu RFC1123 („R”, „r”)The RFC1123 ("R", "r") Format Specifier

Specyfikator formatu standardowego "R" lub "r" reprezentuje niestandardowa data i ciąg formatu godziny, który jest definiowany przez DateTimeFormatInfo.RFC1123Pattern właściwości.The "R" or "r" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.RFC1123Pattern property. Wzorzec odzwierciedla zdefiniowany standard, a właściwość jest tylko do odczytu.The pattern reflects a defined standard, and the property is read-only. Dlatego też zawsze jest taki sam, niezależnie od używanej kultury oraz dostarczonego dostawcy formatów.Therefore, it is always the same, regardless of the culture used or the format provider supplied. Ciąg formatu niestandardowego to „ddd, dd MMM yyyy HH':'mm':'ss 'GMT'”.The custom format string is "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'". Gdy jest używany ten specyfikator formatu standardowego, w operacji formatowania lub analizowania zawsze jest używana niezmienna kultura.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

Ciąg wynikowy mają wpływ następujące właściwości DateTimeFormatInfo obiektu zwróconego przez DateTimeFormatInfo.InvariantInfo właściwość, która reprezentuje niezmienną kulturę.The result string is affected by the following properties of the DateTimeFormatInfo object returned by the DateTimeFormatInfo.InvariantInfo property that represents the invariant culture.

WłaściwośćProperty OpisDescription
RFC1123Pattern Definiuje format ciągu wynikowego.Defines the format of the result string.
AbbreviatedDayNames Definiuje skrócone nazwy dni, które mogą być wyświetlane w ciągu wynikowym.Defines the abbreviated day names that can appear in the result string.
AbbreviatedMonthNames Definiuje skrócone nazwy miesięcy, które mogą być wyświetlane w ciągu wynikowym.Defines the abbreviated month names that can appear in the result string.

Mimo że standard RFC 1123 wyraża czas jako uniwersalny czas koordynowany (UTC), operacja formatowania nie modyfikuje wartości DateTime obiekt, który jest formatowana.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. W związku z tym, należy przekonwertować DateTime wartość na czas UTC, wywołując DateTime.ToUniversalTime metoda przed wykonaniem operacji formatowania.Therefore, you must convert the DateTime value to UTC by calling the DateTime.ToUniversalTime method before you perform the formatting operation. Z kolei DateTimeOffset automatycznie wykonać tę konwersję wartości; nie trzeba wywoływac DateTimeOffset.ToUniversalTime metoda przed operacją formatowania.In contrast, DateTimeOffset values perform this conversion automatically; there is no need to call the DateTimeOffset.ToUniversalTime method before the formatting operation.

W poniższym przykładzie użyto specyfikatora formatu "r", aby wyświetlić DateTime i DateTimeOffset wartość w systemie, w Stanach Zjednoczonych Strefa czasowa czasu pacyficznego.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                        

Powrót do tabeliBack to table

Specyfikator formatu sortowalnego („s”)The Sortable ("s") Format Specifier

Specyfikator formatu standardowego "s" przedstawia niestandardowa data i ciąg formatu godziny, który jest definiowany przez DateTimeFormatInfo.SortableDateTimePattern właściwości.The "s" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.SortableDateTimePattern property. Wzorzec odzwierciedla zdefiniowany standard (ISO 8601), a właściwość jest tylko do odczytu.The pattern reflects a defined standard (ISO 8601), and the property is read-only. Dlatego też zawsze jest taki sam, niezależnie od używanej kultury oraz dostarczonego dostawcy formatów.Therefore, it is always the same, regardless of the culture used or the format provider supplied. Ciąg formatu niestandardowego to „yyyy'-'MM'-'dd'T'HH':'mm':'ss”.The custom format string is "yyyy'-'MM'-'dd'T'HH':'mm':'ss".

Specyfikator formatu "s" ma na celu wyprodukowania ciągi wynikowe, które stale sortowanie w kolejności rosnącej lub malejącej na podstawie wartości daty i godziny.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. W wyniku chociaż specyfikator formatu standardowego "s" reprezentuje wartość daty i godziny w jednolitym formacie, operacji formatowania nie modyfikuje wartości formatowanego w celu odzwierciedlenia obiektu daty i godziny jego DateTime.Kind właściwości lub jego DateTimeOffset.Offset wartość.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. Na przykład ciągi wynikowe generowane przez formatowanie wartości daty i godziny 2014-11-15T18:32:17 + 00:00 i 2014-11-15T18:32:17 + 08:00 są identyczne.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.

Gdy jest używany ten specyfikator formatu standardowego, w operacji formatowania lub analizowania zawsze jest używana niezmienna kultura.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

W poniższym przykładzie użyto specyfikatora formatu "s", aby wyświetlić DateTime i DateTimeOffset wartość w systemie, w Stanach Zjednoczonych Strefa czasowa czasu pacyficznego.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                       

Powrót do tabeliBack to table

Specyfikator formatu godziny krótkiej („t”)The Short Time ("t") Format Specifier

Specyfikator formatu standardowego "t" reprezentuje niestandardowa data i godzina ciąg formatu, który jest definiowany przez bieżącą DateTimeFormatInfo.ShortTimePattern właściwości.The "t" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.ShortTimePattern property. Na przykład ciąg formatu niestandardowego dla niezmiennej kultury to „HH:mm”.For example, the custom format string for the invariant culture is "HH:mm".

Ciąg wynikowy mają wpływ informacje o formatowaniu określonego DateTimeFormatInfo obiektu.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. W poniższej tabeli wymieniono DateTimeFormatInfo obiektu właściwości, które mogą sterować formatowaniem zwracanego ciągu.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Specyfikator formatu niestandardowego, który jest zwracany przez DateTimeFormatInfo.ShortTimePattern właściwość niektórych kultur może nie mieć używać wszystkich właściwości.The custom format specifier that is returned by the DateTimeFormatInfo.ShortTimePattern property of some cultures may not make use of all properties.

WłaściwośćProperty OpisDescription
ShortTimePattern Definiuje format składnika godziny w ciągu wynikowym.Defines the format of the time component of the result string.
TimeSeparator Definiuje ciąg, który rozdziela składniki godziny, minuty i sekundy w ciągu reprezentującym godzinę.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Określa ciąg, który wskazuje czas od północy do południa (z wyłączeniem południa), w formacie 12-godzinnym.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Określa ciąg, który wskazuje czas od południa do północy (z wyłączeniem północy), w formacie 12-godzinnym.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

W poniższym przykładzie użyto specyfikatora formatu „t”, aby wyświetlić wartość daty i godziny.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                      

Powrót do tabeliBack to table

Specyfikator formatu godziny długiej („T”)The Long Time ("T") Format Specifier

Specyfikator formatu standardowego "T" reprezentuje niestandardowa data i godzina ciąg formatu, który jest definiowany przez określoną kulturę DateTimeFormatInfo.LongTimePattern właściwości.The "T" standard format specifier represents a custom date and time format string that is defined by a specific culture's DateTimeFormatInfo.LongTimePattern property. Na przykład ciąg formatu niestandardowego dla niezmiennej kultury to „HH:mm:ss”.For example, the custom format string for the invariant culture is "HH:mm:ss".

W poniższej tabeli wymieniono DateTimeFormatInfo obiektu właściwości, które mogą sterować formatowaniem zwracanego ciągu.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Specyfikator formatu niestandardowego, który jest zwracany przez DateTimeFormatInfo.LongTimePattern właściwość niektórych kultur może nie mieć używać wszystkich właściwości.The custom format specifier that is returned by the DateTimeFormatInfo.LongTimePattern property of some cultures may not make use of all properties.

WłaściwośćProperty OpisDescription
LongTimePattern Definiuje format składnika godziny w ciągu wynikowym.Defines the format of the time component of the result string.
TimeSeparator Definiuje ciąg, który rozdziela składniki godziny, minuty i sekundy w ciągu reprezentującym godzinę.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Określa ciąg, który wskazuje czas od północy do południa (z wyłączeniem południa), w formacie 12-godzinnym.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Określa ciąg, który wskazuje czas od południa do północy (z wyłączeniem północy), w formacie 12-godzinnym.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

W poniższym przykładzie użyto specyfikatora formatu „T”, aby wyświetlić wartość daty i godziny.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                      

Powrót do tabeliBack to table

Specyfikator uniwersalnego sortowalnego formatu („u”)The Universal Sortable ("u") Format Specifier

Specyfikator formatu standardowego "u" reprezentuje niestandardowa data i ciąg formatu godziny, który jest definiowany przez DateTimeFormatInfo.UniversalSortableDateTimePattern właściwości.The "u" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.UniversalSortableDateTimePattern property. Wzorzec odzwierciedla zdefiniowany standard, a właściwość jest tylko do odczytu.The pattern reflects a defined standard, and the property is read-only. Dlatego też zawsze jest taki sam, niezależnie od używanej kultury oraz dostarczonego dostawcy formatów.Therefore, it is always the same, regardless of the culture used or the format provider supplied. Ciąg formatu niestandardowego to „yyyy'-'MM'-'dd HH':'mm':'ss'Z'”.The custom format string is "yyyy'-'MM'-'dd HH':'mm':'ss'Z'". Gdy jest używany ten specyfikator formatu standardowego, w operacji formatowania lub analizowania zawsze jest używana niezmienna kultura.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

Mimo że ciąg wynikowy powinien wyrażać czas jako uniwersalny czas koordynowany (UTC), bez konwersji oryginalny DateTime wartość odbywa się podczas operacji formatowania.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. W związku z tym, należy przekonwertować DateTime wartość na czas UTC, wywołując DateTime.ToUniversalTime metoda przed jego sformatowaniem.Therefore, you must convert a DateTime value to UTC by calling the DateTime.ToUniversalTime method before formatting it. Z kolei DateTimeOffset automatycznie wykonać tę konwersję wartości; nie trzeba wywoływac DateTimeOffset.ToUniversalTime metoda przed operacją formatowania.In contrast, DateTimeOffset values perform this conversion automatically; there is no need to call the DateTimeOffset.ToUniversalTime method before the formatting operation.

W poniższym przykładzie użyto specyfikatora formatu „u”, aby wyświetlić wartość daty i godziny.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                       

Powrót do tabeliBack to table

Specyfikator uniwersalnego pełnego formatu („U”)The Universal Full ("U") Format Specifier

Specyfikator formatu standardowego "U" reprezentuje niestandardowa data i godzina ciąg formatu, który jest definiowany przez określonej kultury DateTimeFormatInfo.FullDateTimePattern właściwości.The "U" standard format specifier represents a custom date and time format string that is defined by a specified culture's DateTimeFormatInfo.FullDateTimePattern property. Wzorzec jest taki sam, jak wzorzec specyfikatora „F”.The pattern is the same as the "F" pattern. Jednak DateTime wartość jest automatycznie konwertowana na czas UTC, przed jego sformatowaniem.However, the DateTime value is automatically converted to UTC before it is formatted.

W poniższej tabeli wymieniono DateTimeFormatInfo obiektu właściwości, które mogą sterować formatowaniem zwracanego ciągu.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. Specyfikator formatu niestandardowego, który jest zwracany przez FullDateTimePattern właściwość niektórych kultur może nie mieć używać wszystkich właściwości.The custom format specifier that is returned by the FullDateTimePattern property of some cultures may not make use of all properties.

WłaściwośćProperty OpisDescription
FullDateTimePattern Definiuje ogólny format ciągu wynikowego.Defines the overall format of the result string.
DayNames Definiuje zlokalizowane nazwy dni, które mogą być wyświetlane w ciągu wynikowym.Defines the localized day names that can appear in the result string.
MonthNames Definiuje zlokalizowane nazwy miesięcy, które mogą być wyświetlane w ciągu wynikowym.Defines the localized month names that can appear in the result string.
TimeSeparator Definiuje ciąg, który rozdziela składniki godziny, minuty i sekundy w ciągu reprezentującym godzinę.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Określa ciąg, który wskazuje czas od północy do południa (z wyłączeniem południa), w formacie 12-godzinnym.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Określa ciąg, który wskazuje czas od południa do północy (z wyłączeniem północy), w formacie 12-godzinnym.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

Specyfikator formatu "U" nie jest obsługiwana przez DateTimeOffset typu i zgłasza FormatException Jeśli jest używany do formatowania DateTimeOffset wartość.The "U" format specifier is not supported by the DateTimeOffset type and throws a FormatException if it is used to format a DateTimeOffset value.

W poniższym przykładzie użyto specyfikatora formatu „U”, aby wyświetlić wartość daty i godziny.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                       

Powrót do tabeliBack to table

Specyfikator formatu roku i miesiąca („Y”)The Year Month ("Y", "y") Format Specifier

Specyfikator formatu standardowego "Y" lub "t" reprezentuje niestandardowa data i ciąg formatu godziny, który jest definiowany przez DateTimeFormatInfo.YearMonthPattern właściwości określonej kultury.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. Na przykład ciąg formatu niestandardowego dla niezmiennej kultury to „yyyy MMMM”.For example, the custom format string for the invariant culture is "yyyy MMMM".

W poniższej tabeli wymieniono DateTimeFormatInfo obiektu właściwości, które sterują formatowaniem zwracanego ciągu.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

WłaściwośćProperty OpisDescription
YearMonthPattern Definiuje ogólny format ciągu wynikowego.Defines the overall format of the result string.
MonthNames Definiuje zlokalizowane nazwy miesięcy, które mogą być wyświetlane w ciągu wynikowym.Defines the localized month names that can appear in the result string.

W poniższym przykładzie użyto specyfikatora formatu „y”, aby wyświetlić wartość daty i godziny.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                       

Powrót do tabeliBack to table

UwagiNotes

Ustawienia panelu sterowaniaControl Panel Settings

Ustawienia w Opcje regionalne i językowe elementu w Panelu sterowania wpływają na ciągi wynikowe generowane przez operację formatowania.The settings in the Regional and Language Options item in Control Panel influence the result string produced by a formatting operation. Te ustawienia są stosowane do inicjalizacji DateTimeFormatInfo obiekt skojarzony z bieżącą kulturą wątku, która zapewnia wartości stosowane do zarządzania formatowaniem.These settings are used to initialize the DateTimeFormatInfo object associated with the current thread culture, which provides values used to govern formatting. Na komputerach, na których są używane różne ustawienia, są generowane różne ciągi wynikowe.Computers that use different settings generate different result strings.

Ponadto, jeśli używasz CultureInfo.CultureInfo(String) Konstruktor do tworzenia wystąpienia nowego CultureInfo obiekt, który reprezentuje tę samą kulturę co bieżąca kultura systemu, wszelkie dostosowania ustanowione przez Opcje regionalne i językowe w Panelu sterowania zostaną zastosowane do nowego CultureInfo obiektu.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. Możesz użyć CultureInfo.CultureInfo(String, Boolean) Konstruktor do tworzenia CultureInfo obiektu, który nie będzie odzwierciedlał dostosowań systemu.You can use the CultureInfo.CultureInfo(String, Boolean) constructor to create a CultureInfo object that does not reflect a system's customizations.

Właściwości obiektu DateTimeFormatInfoDateTimeFormatInfo Properties

Formatowanie mają wpływ właściwości bieżącego DateTimeFormatInfo obiektu, dostarczane niejawnie przez bieżącą kulturę wątku lub jawnie przez IFormatProvider parametru metody, która wywołuje formatowanie.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. Dla IFormatProvider parametru, aplikacja musi podawać CultureInfo obiektu, który reprezentuje kulturę, lub DateTimeFormatInfo obiekt, który reprezentuje datę i godzinę, o których konwencje formatowania określonej kultury.For 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. Wiele standardowych daty i godziny specyfikatorów formatu są aliasami wzorców formatowania definiowanych przez właściwości bieżącego DateTimeFormatInfo obiektu.Many of the standard date and time format specifiers are aliases for formatting patterns defined by properties of the current DateTimeFormatInfo object. Twoja aplikacja może zmieniać wyniki tworzone przez niektóre standardowy format daty i godziny specyfikatorów formatu, zmieniając wzorców odpowiadającego formatu odpowiednią datę i godzinę DateTimeFormatInfo właściwości.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.

Zobacz teżSee Also

System.DateTime
System.DateTimeOffset
Formatowanie typówFormatting Types
Niestandardowe ciągi formatujące datę i godzinęCustom Date and Time Format Strings
Przykład: .NET Framework 4 formatowanie narzędziaSample: .NET Framework 4 Formatting Utility