Standardowe ciągi formatu daty i godziny

Artykuł
03/22/2025

Standardowy ciąg formatu daty i godziny używa pojedynczego znaku jako specyfikatora formatu, aby zdefiniować reprezentację tekstową DateTime lub wartość DateTimeOffset. Dowolny ciąg formatu daty i godziny zawierający więcej niż jeden znak, w tym biały znak, jest interpretowany jako niestandardowy ciąg formatu daty i godziny. Ciąg formatu standardowego lub niestandardowego można używać na dwa sposoby:

Aby zdefiniować ciąg, który wynika z operacji formatowania.
Aby zdefiniować tekstową reprezentację wartości daty i godziny, którą można przekonwertować na wartość DateTime lub DateTimeOffset przez operację analizowania.

Wskazówka

Możesz pobrać narzędzie formatowania , aplikację .NET Windows Forms, która umożliwia stosowanie ciągów formatu do wartości liczbowych lub daty i godziny oraz wyświetlania ciągu wynikowego. Kod źródłowy jest dostępny dla C# i Visual Basic.

Uwaga

Niektóre przykłady języka C# w tym artykule są uruchamiane w Try.NET wbudowanym modułu uruchamiającego kod i plac zabaw. Wybierz przycisk Uruchom, aby uruchomić przykład w oknie interaktywnym. Po wykonaniu kodu można go zmodyfikować i uruchomić zmodyfikowany kod, wybierając ponownie Uruchom. Zmodyfikowany kod jest uruchamiany w oknie interaktywnym lub, jeśli kompilacja zakończy się niepowodzeniem, w oknie interaktywnym zostaną wyświetlone wszystkie komunikaty o błędach kompilatora języka C#.

Lokalna strefa czasowa wbudowanego modułu uruchamiającego kod Try.NET i plac zabaw to uniwersalny czas koordynowany lub UTC. Może to mieć wpływ na zachowanie i dane wyjściowe przykładów ilustrujących typy DateTime, DateTimeOffseti TimeZoneInfo oraz ich składowe.

Tabela specyfikatorów formatu

W poniższej tabeli opisano standardowe specyfikatory formatu daty i godziny. Jeśli nie określono inaczej, określony standardowy specyfikator formatu daty i godziny tworzy identyczną reprezentację ciągu niezależnie od tego, czy jest używany z wartością DateTime czy DateTimeOffset. Aby uzyskać dodatkowe informacje na temat używania standardowych ciągów formatu daty i godziny, zobacz Ustawienia panelu sterowania i Właściwości DateTimeFormat Info.

Specyfikator formatu	Opis	Przykłady
"d"	Wzorzec daty krótkiej. Więcej informacji:specyfikator formatu daty krótkiej ("d").	2009-06-15T13:45:30 -> 6/15/2009 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	Wzorzec daty długiej. Więcej informacji:specyfikator formatu daty długiej ("D").	2009-06-15T13:45:30 —> poniedziałek, 15 czerwca 2009 r. (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
f	Wzorzec pełnej daty/godziny (godzina krótka). Więcej informacji: Specyfikator formatu pełnej daty krótkiej ("f").	2009-06-15T13:45:30 -> poniedziałek, 15 czerwca 2009 13:45 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Δευτιρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
„F”	Wzorzec pełnej daty/godziny (godzina długa). Więcej informacji: Specyfikator formatu daty pełnej daty długiej ("F").	2009-06-15T13:45:30 -> poniedziałek, 15 czerwca 2009 1:45:30 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτιρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
„g”	Wzorzec ogólnej daty/godziny (godzina krótka). Więcej informacji: Specyfikator formatu daty ogólnej daty krótkiej ("g").	2009-06-15T13:45:30 -> 6/15/2009 1:45 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
„G”	Wzorzec ogólnej daty/godziny (godzina długa). Więcej informacji: Specyfikator formatu daty ogólnej daty długiej ("G").	2009-06-15T13:45:30 -> 6/15/2009 1:45:30 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
„M”, „m”	Wzorzec miesiąc/dzień. Więcej informacji: Specyfikator formatu miesiąca ("M", "m").	2009-06-15T13:45:30 —> 15 czerwca (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
„O”, „o”	wzorzec daty/godziny w obie strony. Więcej informacji: Specyfikator formatu round-trip ("O", "o").	DateTime wartości: 2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30.0000000-07:00 2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30.000000Z 2009-06-15T13:45:30 (DateTimeKind.Unspecified) -> 2009-06-15T13:45:30.0000000 DateTimeOffset wartości: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
„R”, „r”	Wzorzec RFC1123. Więcej informacji: specyfikator formatu RFC1123 ("R", "r").	DateTimeOffset dane wejściowe: 2009-06-15T13:45:30 -> Mon, 15 Czerwca 2009 20:45:30 GMT DateTime dane wejściowe: 2009-06-15T13:45:30 -> Mon, 15 Czerwca 2009 13:45:30 GMT
„s”	Wzorzec sortowalnej daty/godziny. Więcej informacji: Specyfikator formatu sortowalnego ("s").	2009-06-15T13:45:30 (DateTimeKind.Local) —> 2009-06-15T13:45:30 2009-06-15T13:45:30 (DateTimeKind.Utc) —> 2009-06-15T13:45:30
t	Wzorzec godziny krótkiej. Więcej informacji: Specyfikator formatu skróconego ("t").	2009-06-15T13:45:30-1> :45 (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
„T”	Wzorzec godziny długiej. Więcej informacji: Specyfikator formatu długiego ("T").	2009-06-15T13:45:30 -> 1:45:30 (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
„u”	Wzorzec uniwersalnej sortowalnej daty/godziny. Więcej informacji: Specyfikator formatu uniwersalnego sortowania ("u").	Z wartością DateTime: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z Z wartością DateTimeOffset: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Uniwersalny wzorzec pełnej daty/godziny. Więcej informacji: specyfikator formatu uniwersalnego pełnego ("U").	2009-06-15T13:45:30 -> poniedziałek, 15 czerwca 2009 18:45:30 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 20:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτιρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
„Y”, „y”	Wzorzec roku i miesiąca. Więcej informacji: Specyfikator formatu miesiąca roku ("Y").	2009-06-15T13:45:30 —> czerwiec 2009 (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Jakikolwiek inny pojedynczy znak	Nieznany specyfikator.	Zgłasza FormatExceptionczasu wykonywania.

Jak działają standardowe ciągi formatu

W operacji formatowania ciąg formatu standardowego jest po prostu aliasem ciągu formatu niestandardowego. 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. Jest to ważne, ponieważ ciągi reprezentujące wartości daty i godziny są zazwyczaj różne w zależności od kultury. Na przykład ciąg formatu standardowego „d” wskazuje, że wartość daty i godziny zostanie wyświetlona przy użyciu wzorca daty krótkiej. Ten wzorzec dla niezmiennej kultury to „MM/dd/yyyy”. Dla kultury fr-FR jest to „dd/MM/yyyy”. Dla kultury ja-JP jest to „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:

Można użyć domyślnej (bieżącej) kultury. W poniższym przykładzie data jest wyświetlana przy użyciu formatu daty krótkiej dla bieżącej kultury. Bieżącą kulturą jest w tym przypadku kultura 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. W poniższym przykładzie data jest wyświetlana przy użyciu formatu daty krótkiej dla kultury pt-BR.

// Display using pt-BR culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
CultureInfo culture = new CultureInfo("pt-BR");
Console.WriteLine(thisDate.ToString("d", culture));  // Displays 15/3/2008

' Display using pt-BR culture's short date format
Dim thisDate As Date = #03/15/2008#
Dim culture As New CultureInfo("pt-BR")
Console.WriteLine(thisDate.ToString("d", culture))   ' Displays 15/3/2008

Można przekazać obiekt DateTimeFormatInfo, który udostępnia informacje o formatowaniu do metody, która ma parametr IFormatProvider. Poniższy przykład przedstawia datę przy użyciu formatu daty krótkiej z obiektu DateTimeFormatInfo dla kultury hr-HR.

// Display using date format information from hr-HR culture
DateTime thisDate = new DateTime(2008, 3, 15);
DateTimeFormatInfo fmt = (new CultureInfo("hr-HR")).DateTimeFormat;
Console.WriteLine(thisDate.ToString("d", fmt));      // Displays 15.3.2008

' Display using date format information from hr-HR culture
Dim thisDate As Date = #03/15/2008#
Dim fmt As DateTimeFormatInfo = (New CultureInfo("hr-HR")).DateTimeFormat
Console.WriteLine(thisDate.ToString("d", fmt))   ' Displays 15.3.2008

Uwaga

Aby uzyskać informacje na temat dostosowywania wzorców lub ciągów używanych w formatowaniu wartości daty i godziny, zobacz temat klasy NumberFormatInfo.

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. Cztery ciągi formatu standardowego należą do tej kategorii: „O” (lub „o”), „R” (lub „r”), „s” i „u”. Te ciągi odpowiadają ciągom formatów niestandardowych, które są zdefiniowane przez niezmienną kulturę. Wytwarzają one reprezentacje wartości daty i godziny w postaci ciągu, które mają być identyczne dla różnych kultur. W poniższej tabeli przedstawiono informacje dotyczące tych czterech ciągów standardowych formatów daty i godziny.

Ciąg formatu standardowego	Zdefiniowana przez właściwość DateTimeFormatInfo.InvariantInfo	Ciąg formatu niestandardowego
„O” lub „o”	Żaden	yyyy'-'MM'-'dd'T'HH':'mm':'ss''. fffffffK
„R” lub „r”	RFC1123Pattern	ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
„s”	SortableDateTimePattern	yyyy'-'MM'-'dd'T'HH':'mm':'ss
„u”	UniversalSortableDateTimePattern	yyyy'-'MM'-'dd HH':'mm':'ss'Z'

Ciągi formatu standardowego mogą być również używane w operacjach analizowania za pomocą metod DateTime.ParseExact lub DateTimeOffset.ParseExact, które wymagają, aby ciąg wejściowy był dokładnie zgodny z określonym wzorcem, aby operacja analizy zakończyła się powodzeniem. Wiele standardowych ciągów formatu mapuje się na wiele ciągów formatu niestandardowego, więc wartość daty i godziny może być reprezentowana w różnych formatach, a operacja analizowania nadal powiedzie się. Można określić ciąg formatu niestandardowego lub ciągi, które odpowiadają ciągowi formatu standardowego, wywołując metodę DateTimeFormatInfo.GetAllDateTimePatterns(Char). W poniższym przykładzie przedstawiono niestandardowe ciągi formatu mapujące ciągi formatu "d" (wzorzec daty krótkiej) na standardowy ciąg formatu.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("'d' standard format string:");
      foreach (var customString in DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns('d'))
          Console.WriteLine($"   {customString}");
   }
}
// The example displays the following output:
//       'd' standard format string:
//          M/d/yyyy
//          M/d/yy
//          MM/dd/yy
//          MM/dd/yyyy
//          yy/MM/dd
//          yyyy-MM-dd
//          dd-MMM-yy

Imports System.Globalization

Module Example
    Public Sub Main()
        Console.WriteLine("'d' standard format string:")
        For Each customString In DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns("d"c)
            Console.WriteLine("   {0}", customString)
        Next
    End Sub
End Module
' The example displays the following output:
'    'd' standard format string:
'       M/d/yyyy
'       M/d/yy
'       MM/dd/yy
'       MM/dd/yyyy
'       yy/MM/dd
'       yyyy-MM-dd
'       dd-MMM-yy

W poniższych sekcjach opisano standardowe specyfikatory formatu dla wartości DateTime i DateTimeOffset.

Formaty dat

Ta grupa zawiera następujące formaty:

Specyfikator formatu daty krótkiej ("d")
Specyfikator formatu daty długiej ("D")

Specyfikator formatu daty krótkiej ("d")

Specyfikator formatu standardowego "d" reprezentuje niestandardowy ciąg formatu daty i godziny zdefiniowany przez właściwość DateTimeFormatInfo.ShortDatePattern określonej kultury. Na przykład ciąg formatu niestandardowego zwracany przez właściwość ShortDatePattern niezmiennej kultury to "MM/dd/yyyy".

W poniższej tabeli wymieniono właściwości obiektu DateTimeFormatInfo, które kontrolują formatowanie zwracanego ciągu.

Nieruchomość	Opis
ShortDatePattern	Definiuje ogólny format ciągu wynikowego.
DateSeparator	Definiuje ciąg oddzielający składniki roku, miesiąca i dnia daty.

W poniższym przykładzie użyto specyfikatora formatu "d", aby wyświetlić wartość daty i godziny.

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

Nieruchomość	Opis
LongDatePattern	Definiuje ogólny format ciągu wynikowego.
DayNames	Definiuje zlokalizowane nazwy dni, które mogą być wyświetlane w ciągu wynikowym.
MonthNames	Definiuje zlokalizowane nazwy miesięcy, które mogą być wyświetlane w ciągu wynikowym.

Nieruchomość	Opis
LongDatePattern	Definiuje format składnika daty ciągu wynikowego.
ShortTimePattern	Definiuje format składnika czasu ciągu wynikowego.
DayNames	Definiuje zlokalizowane nazwy dni, które mogą być wyświetlane w ciągu wynikowym.
MonthNames	Definiuje zlokalizowane nazwy miesięcy, które mogą być wyświetlane w ciągu wynikowym.
TimeSeparator	Definiuje ciąg, który oddziela składniki godziny, minuty i sekundy czasu.
AMDesignator	Definiuje ciąg, który wskazuje godziny od północy do południa w 12-godzinnym zegarze.
PMDesignator	Definiuje ciąg, który wskazuje godziny od południa do północy w 12-godzinnym zegarze.

Nieruchomość	Opis
FullDateTimePattern	Definiuje ogólny format ciągu wynikowego.
DayNames	Definiuje zlokalizowane nazwy dni, które mogą być wyświetlane w ciągu wynikowym.
MonthNames	Definiuje zlokalizowane nazwy miesięcy, które mogą być wyświetlane w ciągu wynikowym.
TimeSeparator	Definiuje ciąg, który oddziela składniki godziny, minuty i sekundy czasu.
AMDesignator	Definiuje ciąg, który wskazuje godziny od północy do południa w 12-godzinnym zegarze.
PMDesignator	Definiuje ciąg, który wskazuje godziny od południa do północy w 12-godzinnym zegarze.

Nieruchomość	Opis
ShortDatePattern	Definiuje format składnika daty ciągu wynikowego.
LongTimePattern	Definiuje format składnika czasu ciągu wynikowego.
DateSeparator	Definiuje ciąg oddzielający składniki roku, miesiąca i dnia daty.
TimeSeparator	Definiuje ciąg, który oddziela składniki godziny, minuty i sekundy czasu.
AMDesignator	Definiuje ciąg, który wskazuje godziny od północy do południa w 12-godzinnym zegarze.
PMDesignator	Definiuje ciąg, który wskazuje godziny od południa do północy w 12-godzinnym zegarze.

Nieruchomość	Opis
RFC1123Pattern	Definiuje format ciągu wynikowego.
AbbreviatedDayNames	Definiuje skrócone nazwy dni, które mogą być wyświetlane w ciągu wynikowym.
AbbreviatedMonthNames	Definiuje skrócone nazwy miesięcy, które mogą być wyświetlane w ciągu wynikowym.

Nieruchomość	Opis
MonthDayPattern	Definiuje ogólny format ciągu wynikowego.
MonthNames	Definiuje zlokalizowane nazwy miesięcy, które mogą być wyświetlane w ciągu wynikowym.

Nieruchomość	Opis
YearMonthPattern	Definiuje ogólny format ciągu wynikowego.
MonthNames	Definiuje zlokalizowane nazwy miesięcy, które mogą być wyświetlane w ciągu wynikowym.

Udostępnij za pośrednictwem

Standardowe ciągi formatu daty i godziny

Tabela specyfikatorów formatu

Jak działają standardowe ciągi formatu

Formaty dat

Specyfikator formatu daty krótkiej ("d")

Specyfikator formatu daty długiej ("D")

Formaty daty i godziny

Specyfikator formatu daty pełnej daty krótkiej ("f")

Specyfikator formatu daty pełnej daty długiej ("F")

Specyfikator formatu daty ogólnej daty krótkiej ("g")

Specyfikator formatu daty ogólnej daty długiej ("G")

Specyfikator formatu round-trip ("O", "o")

Specyfikator formatu RFC1123 ("R", "r")

Specyfikator formatu sortowalnego ("s")

Specyfikator formatu uniwersalnego sortowania ("u")

Specyfikator formatu uniwersalnego pełnego ("U")

Formaty czasu

Specyfikator formatu czasowego ("t")

Specyfikator formatu długiego ("T")

Częściowe formaty dat

Specyfikator formatu miesiąca ("M", "m")

Specyfikator formatu miesiąca roku ("Y", "y")

Ustawienia panelu sterowania

Właściwości DateTimeFormatInfo

Zobacz też

Dodatkowe zasoby