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. Dowolny ciąg formatu daty i godziny, który zawiera więcej niż jeden znak, w tym znak odstępu, jest interpretowany jako ciąg niestandardowego formatu daty i godziny; Aby uzyskać więcej informacji, zobacz Niestandardowe ciągi formatujące datę i godzinę.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óra może zostać przekonwertowana na wartość DateTime lub DateTimeOffset za pomocą operacji analizowania.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 formatowania, aplikację .net Core Windows Forms, która umożliwia stosowanie ciągów formatowania do wartości liczbowych lub daty i godziny i wyświetla ciąg wynikowy.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. Kod źródłowy jest dostępny dla C# i Visual Basic.Source code is available for C# and Visual Basic.

Ciągi standardowego formatu daty i godziny mogą być używane z wartościami DateTime i DateTimeOffset.Standard date and time format strings can be used with both DateTime and DateTimeOffset values.

Uwaga

Niektóre C# przykłady w tym artykule działają w module uruchamiającego kod wbudowany try.NET i plac zabaw.Some of the C# examples in this article run in the Try.NET inline code runner and playground. Wybierz przycisk Run (Uruchom ), aby uruchomić przykład w oknie interaktywnym.Select the Run button to run an example in an interactive window. Po wykonaniu kodu można go zmodyfikować i uruchomić zmodyfikowany kod, wybierając pozycję Uruchom ponownie.Once you execute the code, you can modify it and run the modified code by selecting Run again. Zmodyfikowany kod jest uruchamiany w oknie interaktywnym lub, jeśli kompilacja nie powiedzie się, w oknie interaktywnym zostaną C# wyświetlone wszystkie komunikaty o błędach kompilatora.The modified code either runs in the interactive window or, if compilation fails, the interactive window displays all C# compiler error messages.

Lokalna strefa czasowa try.NET wbudowanego modułu uruchamiającego kod i plac zabaw jest uniwersalnym czasem koordynowanym (UTC).The local time zone of the Try.NET inline code runner and playground is Coordinated Universal Time, or UTC. Może to mieć wpływ na zachowanie i dane wyjściowe przykładów, które ilustrują typy DateTime, DateTimeOffseti TimeZoneInfo oraz ich członków.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 specyfikatory standardowego formatu daty i godziny.The following table describes the standard date and time format specifiers. O ile nie zaznaczono inaczej, określony standardowy specyfikator formatu daty i godziny generuje identyczny ciąg reprezentacji, niezależnie od tego, czy jest używany z wartością DateTime lub DateTimeOffset.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 sekcję uwagi , aby uzyskać dodatkowe informacje dotyczące używania ciągów standardowego formatu daty i godziny.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:specyfikator formatu daty krótkiej ("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" 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, 15 czerwca, 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" Wzorzec pełnej daty/godziny (godzina krótka).Full date/time pattern (short time).

Więcej informacji: specyfikator formatu pełnej daty i godziny krótkiej ("f").More information: The Full Date Short Time ("f") Format Specifier.
2009-06-15T13:45:30-> poniedziałek, 15 czerwca, 2009 1:45 PM (pl-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" 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, 15 czerwca, 2009 1:45:30 PM (pl-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" Wzorzec ogólnej daty/godziny (godzina krótka).General date/time pattern (short time).

Więcej informacji: specyfikator formatu daty ogólnej i godziny krótkiej ("g").More information: The General Date Short Time ("g") Format Specifier.
2009-06-15T13:45:30-> 6/15/2009 1:45 PM (pl-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" Wzorzec ogólnej daty/godziny (godzina długa).General date/time pattern (long time).

Więcej informacji: specyfikator formatu daty ogólnej 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 (pl-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" 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 — > Czerwiec 15 (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 (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 rundying ("o", "o").More information: The Round-trip ("O", "o") Format Specifier.
wartości DateTime: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.0000000 Z2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z

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

wartości DateTimeOffset: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: specyfikator formatu RFC1123 ("r", "r").More information: The RFC1123 ("R", "r") Format Specifier.
2009-06-15T13:45:30-> PN, 15 Jun 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: specyfikator formatu sortowania ("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" Wzorzec godziny krótkiej.Short time pattern.

Więcej informacji: specyfikator formatu godziny krótkiej ("t").More information: The Short Time ("t") Format Specifier.
2009-06-15T13:45:30-> 1:45 PM (pl-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" 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 (pl-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" Wzorzec uniwersalnej sortowalnej daty/godziny.Universal sortable date/time pattern.

Więcej informacji: specyfikator formatu uniwersalnego sortowania ("u").More information: The Universal Sortable ("u") Format Specifier.
O wartości DateTime: 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

O wartości DateTimeOffset: 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 formatu uniwersalnego pełnego ("U").More information: The Universal Full ("U") Format Specifier.
2009-06-15T13:45:30-> poniedziałek, 15 czerwca, 2009 8:45:30 PM (pl-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" Wzorzec roku i miesiąca.Year month pattern.

Więcej informacji: specyfikator formatu roku miesiąca ("Y").More information: The Year Month ("Y") Format Specifier.
2009-06-15T13:45:30-> czerwiec, 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 (identyfikator ID)2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Jakikolwiek inny pojedynczy znakAny other single character Nieznany specyfikator.Unknown specifier. Zgłasza FormatExceptionczasu wykonywania.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żna przekazać obiekt CultureInfo reprezentujący kulturę, której formatowanie ma być używane, do metody, która ma parametr IFormatProvider.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żna przekazać obiekt DateTimeFormatInfo, który dostarcza informacje o formatowaniu do metody, która ma parametr IFormatProvider.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 obiektu DateTimeFormatInfo 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 na temat dostosowywania wzorców lub ciągów używanych w formatowaniu wartości daty i godziny, zobacz temat Klasa NumberFormatInfo.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 formatu standardowego mogą być również używane podczas analizowania operacji przy użyciu metod DateTime.ParseExact lub DateTimeOffset.ParseExact, które wymagają, aby ciąg wejściowy był dokładnie zgodny z określonym wzorcem dla 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. Możesz określić ciąg formatu niestandardowego lub ciągi, które odpowiadają ciągowi standardowego formatu, wywołując metodę DateTimeFormatInfo.GetAllDateTimePatterns(Char).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 wartości DateTime i DateTimeOffset.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 ciąg niestandardowego formatu daty i godziny, który jest zdefiniowany przez właściwość DateTimeFormatInfo.ShortDatePattern określonej kultury.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 właściwość ShortDatePattern kultury niezmiennej, to "MM/DD/RRRR".For example, the custom format string that is returned by the ShortDatePattern property of the invariant culture is "MM/dd/yyyy".

Poniższa tabela zawiera listę właściwości obiektu DateTimeFormatInfo, które kontrolują formatowanie 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                       

Wróć do tabeliBack to table

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

Specyfikator formatu standardowego "D" reprezentuje ciąg niestandardowego formatu daty i godziny, który jest definiowany przez bieżącą Właściwość DateTimeFormatInfo.LongDatePattern.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 obiektu DateTimeFormatInfo, które kontrolują formatowanie 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                        

Wróć 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.

Informacje o formatowaniu określonego obiektu DateTimeFormatInfo mają wpływ na ciąg wynikowy.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. Poniższa tabela zawiera listę właściwości obiektu DateTimeFormatInfo, które mogą kontrolować formatowanie 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 właściwości DateTimeFormatInfo.LongDatePattern i DateTimeFormatInfo.ShortTimePattern niektórych kultur może nie 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                       

Wróć 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 ciąg niestandardowego formatu daty i godziny, który jest definiowany przez bieżącą Właściwość DateTimeFormatInfo.FullDateTimePattern.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".

Poniższa tabela zawiera listę właściwości obiektu DateTimeFormatInfo, które mogą kontrolować formatowanie 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 właściwość FullDateTimePattern niektórych kultur może nie 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                       

Wróć 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.

Informacje o formatowaniu określonego obiektu DateTimeFormatInfo mają wpływ na ciąg wynikowy.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. Poniższa tabela zawiera listę właściwości obiektu DateTimeFormatInfo, które mogą kontrolować formatowanie 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 właściwości DateTimeFormatInfo.ShortDatePattern i DateTimeFormatInfo.ShortTimePattern niektórych kultur może nie 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                        

Wróć 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.

Informacje o formatowaniu określonego obiektu DateTimeFormatInfo mają wpływ na ciąg wynikowy.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. Poniższa tabela zawiera listę właściwości obiektu DateTimeFormatInfo, które mogą kontrolować formatowanie 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 właściwości DateTimeFormatInfo.ShortDatePattern i DateTimeFormatInfo.LongTimePattern niektórych kultur może nie 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                       

Wróć do tabeliBack to table

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

Specyfikator formatu standardowego "M" lub "m" reprezentuje ciąg niestandardowego formatu daty i godziny, który jest zdefiniowany przez bieżącą Właściwość DateTimeFormatInfo.MonthDayPattern.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".

Poniższa tabela zawiera listę właściwości obiektu DateTimeFormatInfo, które kontrolują formatowanie 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                       

Wróć do tabeliBack to table

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

Specyfikator formatu standardowego "O" lub "o" reprezentuje ciąg niestandardowego formatu daty i 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. W przypadku wartości DateTime ten specyfikator formatu jest przeznaczony do zachowywania wartości daty i godziny wraz z właściwością DateTime.Kind 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że być analizowany z powrotem przy użyciu metody DateTime.Parse(String, IFormatProvider, DateTimeStyles) lub DateTime.ParseExact, jeśli styles parametr jest ustawiony na 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 elementowi "yyyy'-'MM'-'dd'T'HH": "mm": "SS". fffffffK "niestandardowy ciąg formatu dla wartości DateTime i do" yyyy'-'MM'-'dd'T'HH ":" mm ":" SS "." fffffffzzz "niestandardowy ciąg formatu dla wartości DateTimeOffset.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". " fffffffK "niestandardowy ciąg formatu) korzysta z trzech sposobów, w jaki ISO 8601 reprezentuje informacje o strefie czasowej, aby zachować Właściwość Kind 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ęciem od 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 wartości DateTimeOffset są również reprezentowane w tym formacie.All DateTimeOffset values are also represented in this format.

  • Składnik strefy czasowej DateTimeKind.Utc wartości daty i godziny używa "Z" (co oznacza przesunięcie zerowe) do reprezentowania czasu 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 zawierają informacji o strefie czasowej.DateTimeKind.Unspecified date and time values have no time zone information.

Ze względu na to, że specyfikator formatu standardowego "O" lub "o" jest zgodny ze standardem międzynarodowym, Operacja formatowania lub analizowania, która używa specyfikatora zawsze używa niezmiennej kultury i kalendarza gregoriańskiego.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ą przesyłane do Parse, TryParse, ParseExacti TryParseExact metod DateTime i DateTimeOffset można analizować przy użyciu specyfikatora formatu "O" lub "o", jeśli znajdują się 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 DateTime obiektów, przetwarzanie przeciążenia, które można wywołać, powinno również zawierać parametr styles o 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 w przypadku wywołania metody analizy z niestandardowym ciągiem formatu, który odpowiada specyfikatorowi formatu "O" lub "o", nie da się uzyskać tych samych wyników co "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". Wynika to z faktu, że metody analizy używające niestandardowego ciągu formatu nie mogą przeanalizować ciągu reprezentującego wartości daty i godziny, które nie są składnikiem strefy czasowej, lub użyć "Z", aby wskazać czas 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 pokazano użycie specyfikatora formatu "o", aby wyświetlić serię wartości DateTime i DateTimeOffset wartość w systemie w strefie czasowej pacyficznego w Stanach Zjednoczonych.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 przywraca oryginalną wartość daty i godziny, wywołując metodę Parse daty i godziny.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.

Wróć do tabeliBack to table

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

Specyfikator formatu standardowego "R" lub "r" reprezentuje ciąg niestandardowego formatu daty i godziny, który jest zdefiniowany przez właściwość DateTimeFormatInfo.RFC1123Pattern.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.

Na ciąg wynikowy mają wpływ następujące właściwości obiektu DateTimeFormatInfo zwrócone przez właściwość DateTimeFormatInfo.InvariantInfo, 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 formatowanego obiektu DateTime.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ć wartość DateTime na czas UTC, wywołując metodę DateTime.ToUniversalTime 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 wartości DateTimeOffset automatycznie wykonują tę konwersję; nie ma potrzeby wywoływania metody DateTimeOffset.ToUniversalTime 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 pokazano użycie specyfikatora formatu "r", aby wyświetlić DateTime i DateTimeOffset wartość w systemie w strefie czasowej pacyficznego w Stanach Zjednoczonych.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                        

Wróć do tabeliBack to table

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

Specyfikator formatu standardowego "s" reprezentuje ciąg niestandardowego formatu daty i godziny zdefiniowany przez właściwość DateTimeFormatInfo.SortableDateTimePattern.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" polega na wykorzystaniu ciągów wynikowych, które są sortowane 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 związku z tym, chociaż specyfikator formatu standardowego "s" reprezentuje wartość daty i godziny w spójnym formacie, Operacja formatowania nie modyfikuje wartości obiektu daty i godziny, który jest formatowany w celu odzwierciedlenia jego właściwości DateTime.Kind lub jego DateTimeOffset.Offset wartościami.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 tworzone 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 przedstawiono użycie specyfikatora formatu "s", aby wyświetlić DateTime i DateTimeOffset wartość w systemie w strefie czasowej pacyficznego w Stanach Zjednoczonych.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                       

Wróć do tabeliBack to table

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

Specyfikator formatu standardowego "t" reprezentuje ciąg niestandardowego formatu daty i godziny, który jest definiowany przez bieżącą Właściwość DateTimeFormatInfo.ShortTimePattern.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".

Informacje o formatowaniu określonego obiektu DateTimeFormatInfo mają wpływ na ciąg wynikowy.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. Poniższa tabela zawiera listę właściwości obiektu DateTimeFormatInfo, które mogą kontrolować formatowanie 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 właściwość DateTimeFormatInfo.ShortTimePattern niektórych kultur może nie 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                      

Wróć do tabeliBack to table

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

Specyfikator formatu standardowego "T" reprezentuje ciąg niestandardowego formatu daty i godziny, który jest zdefiniowany przez właściwość DateTimeFormatInfo.LongTimePattern określonej kultury.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".

Poniższa tabela zawiera listę właściwości obiektu DateTimeFormatInfo, które mogą kontrolować formatowanie 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 właściwość DateTimeFormatInfo.LongTimePattern niektórych kultur może nie 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                      

Wróć do tabeliBack to table

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

Specyfikator formatu standardowego "u" reprezentuje ciąg niestandardowego formatu daty i godziny zdefiniowany przez właściwość DateTimeFormatInfo.UniversalSortableDateTimePattern.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), konwersja oryginalnej wartości DateTime nie jest wykonywana 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ć wartość DateTime na czas UTC, wywołując metodę DateTime.ToUniversalTime przed formatowaniem.Therefore, you must convert a DateTime value to UTC by calling the DateTime.ToUniversalTime method before formatting it. Z kolei wartości DateTimeOffset automatycznie wykonują tę konwersję; nie ma potrzeby wywoływania metody DateTimeOffset.ToUniversalTime 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                       

Wróć do tabeliBack to table

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

Specyfikator formatu standardowego "U" reprezentuje ciąg niestandardowego formatu daty i godziny, który jest definiowany przez określoną właściwość DateTimeFormatInfo.FullDateTimePattern kultury.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 wartość DateTime jest automatycznie konwertowana na czas UTC przed sformatowaniem.However, the DateTime value is automatically converted to UTC before it is formatted.

Poniższa tabela zawiera listę właściwości obiektu DateTimeFormatInfo, które mogą kontrolować formatowanie 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 właściwość FullDateTimePattern niektórych kultur może nie 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ługiwany przez typ DateTimeOffset i zgłasza FormatException, jeśli służy do formatowania wartości DateTimeOffset.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                       

Wróć do tabeliBack to table

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

Specyfikator formatu standardowego "Y" lub "y" reprezentuje ciąg niestandardowego formatu daty i godziny, który jest zdefiniowany przez właściwość DateTimeFormatInfo.YearMonthPattern 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".

Poniższa tabela zawiera listę właściwości obiektu DateTimeFormatInfo, które kontrolują formatowanie 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                       

Wróć do tabeliBack to table

UwagiNotes

Ustawienia panelu sterowaniaControl Panel Settings

Ustawienia w elemencie Opcje regionalne i językowe w panelu sterowania wpływają na ciąg wynikowy generowany 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ą używane do inicjowania obiektu DateTimeFormatInfo skojarzonego z bieżącą kulturą wątku, która zapewnia wartości używane 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 konstruktora CultureInfo.CultureInfo(String) do utworzenia wystąpienia nowego obiektu CultureInfo, który reprezentuje tę samą kulturę co bieżąca kultura systemu, wszelkie dostosowania ustanowione przez element Opcje regionalne i językowe w panelu sterowania będą zastosowano do nowego obiektu CultureInfo.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żna użyć konstruktora CultureInfo.CultureInfo(String, Boolean), aby utworzyć obiekt CultureInfo, który nie 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

Na formatowanie mają wpływ właściwości bieżącego obiektu DateTimeFormatInfo, który jest dostarczany niejawnie przez bieżącą kulturę wątku lub jawnie przez parametr IFormatProvider 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 parametru IFormatProvider aplikacja powinna określać obiekt CultureInfo, który reprezentuje kulturę, lub obiekt DateTimeFormatInfo, który reprezentuje konwencje formatowania daty i godziny 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 specyfikatorów standardowego formatu daty i godziny to aliasy dla wzorców formatowania zdefiniowanych przez właściwości bieżącego obiektu DateTimeFormatInfo.Many of the standard date and time format specifiers are aliases for formatting patterns defined by properties of the current DateTimeFormatInfo object. Aplikacja może zmienić wynik wygenerowany przez niektóre standardowe specyfikatory formatu daty i godziny, zmieniając odpowiednie wzorce formatu daty i godziny odpowiadającej właściwości DateTimeFormatInfo.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 takżeSee also