Строки стандартных форматов даты и времени

Статья
04/11/2023

Строка стандартного формата даты и времени использует один символ в качестве описателя формата для определения текстового представления DateTime или значения DateTimeOffset. Любая строка формата даты и времени, содержащая более одной буквы, включая пробелы, интерпретируется как строка пользовательского формата даты и времени. Строку стандартного или пользовательского формата можно использовать двумя способами:

Для определения строки, являющейся результатом операции форматирования.
Для определения текстового представления значения даты и времени, которое можно преобразовать в значение DateTime или DateTimeOffset с помощью операции синтаксического анализа.

Совет

Вы можете загрузить служебную программу форматирования — приложение Windows Forms для .NET, позволяющее применять строки формата к значениям даты и времени и числовым значениям и отображающее результирующую строку. Исходный код доступен для C# и Visual Basic.

Примечание

Некоторые примеры C# в этой статье выполняются во встроенном средстве выполнения кода и на тестовой площадке Try.NET. Нажмите на кнопку Выполнить, чтобы выполнить пример в интерактивном окне. После выполнения кода вы можете изменить его и выполнить измененный код, снова нажав на кнопку Выполнить. Либо в интерактивном окне выполняется измененный код, либо, если компиляция завершается с ошибкой, в интерактивном окне отображаются все сообщения об ошибках компилятора C#.

Местный часовой пояс площадки и средства запуска встроенного кода Try.NET указан в формате UTC. Это может повлиять на работу и выходные данные примеров, иллюстрирующих DateTime, DateTimeOffset, типы TimeZoneInfo и их члены.

Таблица описателей формата

В следующей таблице описаны спецификаторы стандартных форматов даты и времени. Если не указано иное, то описатель стандартного формата даты и времени выдает одинаковое строковое представление независимо от того, используется ли он со значением DateTime или со значением DateTimeOffset. Дополнительные сведения об использовании стандартных строк формата даты и времени см. в разделе Параметры панели управления и Панель свойств DateTimeFormatInfo.

Описатель формата	Описание	Примеры
"d"	Короткий шаблон даты. Дополнительные сведения см. в подразделе Описатель краткого формата даты ("d").	2009-06-15T13:45:30 -> 15.06.2009 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	Полный шаблон даты. Дополнительные сведения см. в подразделе Описатель полного формата даты ("D").	2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Монтаг, 15. Juni 2009 (de-DE)
"f"	Полный шаблон даты и времени (короткий шаблон времени). Дополнительная информация: Описатель полного формата даты и краткого формата времени ("f").	2009-06-15T13:45:30 -> Понедельник, 15 июня 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"	Полный шаблон даты и времени (полный шаблон времени). Дополнительная информация: Описатель полного формата даты и полного формата времени ("F").	2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. 13:45:30 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE) 2009-06-15T13:45:30 -> Αευτέρα, 15 Ιοιπου 2009 1:45:30 μμ (el-GR)
"g"	Общий шаблон даты и времени (короткий шаблон времени). Дополнительная информация: Описатель общего формата даты и краткого формата времени ("g").	2009-06-15T13:45:30 -> 15.06.2009 13:45 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 06.2009 15 13:45 (zh-CN)
"G"	Общий шаблон даты и времени (полный шаблон времени). Дополнительная информация: Описатель общего формата даты и полного формата времени ("G").	2009-06-15T13:45:30 -> 15.06.2009 13:45:30 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 6/2009/15 13:45:30 (zh-CN)
"M", "m"	Шаблон дней месяца. Дополнительная информация: Описатель формата месяца ("M", "m").	2009-06-15T13:45:30 -> 15 июня (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o"	Шаблон обратного преобразования даты и времени. Дополнительная информация: Описатель формата обратного преобразования ("O", "o").	Значения DateTime: 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.0000000Z 2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.00000000 Значения DateTimeOffset: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
"R", "r"	Шаблон RFC1123. Дополнительная информация: Описатель формата RFC1123 ("R", "r").	DateTimeOffset input: 2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT DateTime input: 2009-06-15T13:45:30 -> Mon, 15 Jun 2009 13:45:30 GMT
"s"	Сортируемый шаблон времени и даты. Дополнительная информация: Описатель сортируемого формата ("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"	Короткий шаблон времени. Дополнительная информация: Описатель краткого формата времени ("t").	2009-06-15T13:45:30 -> 13:45 (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	Полный шаблон времени. Дополнительная информация: Описатель полного формата времени ("T").	2009-06-15T13:45:30 -> 13: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"	Универсальный сортируемый шаблон времени и даты. Дополнительная информация: Описатель универсального сортируемого формата ("u").	Со значением DateTime : 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z Со значением DateTimeOffset : 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Универсальный полный шаблон даты и времени. Дополнительная информация: Описатель универсального полного формата ("U").	2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. 20:45:30 PM (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"	Шаблон месяца года. Дополнительная информация: Описатель формата месяца года ("Y").	2009-06-15T13:45:30 -> Июнь 2009 г. (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Любой другой символ	Неизвестный описатель.	Создает исключение времени выполнения FormatException.

Как работают строки стандартного формата

В операции форматирования строка стандартного формата — это всего лишь псевдоним для строки пользовательского формата. Преимуществом использования псевдонима для ссылки на строку пользовательского формата является то, что при изменении строки пользовательского формата псевдоним может оставаться неизменным. Это важно, поскольку строковые представления значений даты и времени обычно зависят от региональных параметров. Например, строка стандартного формата "d" указывает, что значение даты и времени будет отображаться с использованием шаблона короткого формата даты. Для инвариантных региональных параметров таким шаблоном является "мм/дд/гггг". Для региональных параметров fr-FR это "дд/мм/гггг". Для региональных параметров ja-JP это "гггг/мм/дд".

Если строка стандартного формата в операции форматирования сопоставлена со строкой пользовательского формата для определенных региональных параметров, то приложение может определить конкретные региональные параметры, для которых строки пользовательского формата используются одним из следующих способов:

Можно использовать региональные параметры по умолчанию (или текущие). Следующий пример отображает дату в формате короткой даты, соответствующем текущим региональным параметрам. В этом случае текущими региональными параметрами являются 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
```
Можно передать объект CultureInfo, представляющий язык и региональные параметры, соответствующее которым форматирование будет использоваться методом с параметром IFormatProvider. Следующий пример отображает дату в формате короткой даты, соответствующем региональным параметрам 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
```

Можно передать объект DateTimeFormatInfo, предоставляющий данные форматирования методу с параметром IFormatProvider. В следующем примере дата отображается с помощью короткого формата даты из объекта DateTimeFormatInfo, соответствующего региональным параметрам 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

Примечание

Дополнительные сведения о настройке шаблонов или строк, используемых в форматировании значений даты и времени, см. в статье о классе NumberFormatInfo.

В некоторых случаях строка стандартного формата служит удобным сокращением длинной строки пользовательского формата, который является неизменяемым. В эту категорию попадают четыре строки стандартного формата: "O" (или "o"), "R" (или "r"), "s" и "u". Эти строки соответствуют строкам пользовательского формата, соответствующего инвариантным региональным параметрам. Они создают строковые представления значений даты и времени, которые, предположительно, совпадают для различных региональных параметров. В следующей таблице приведены сведения об этих четырех строках стандартных форматов даты и времени.

Строка стандартного формата	Определена свойством DateTimeFormatInfo.InvariantInfo	Строка пользовательского формата
"O" или "o"	Отсутствуют	yyyy'-'MM'-'dd'T'HH':'mm':'ss'. fffffffK
"R" или "r"	RFC1123Pattern	ддд, дд ммм гггг чч':'мм':'сс 'GMT'
"s"	SortableDateTimePattern	гггг'-'мм'-'дд'T'чч':'мм':'сс
"u"	UniversalSortableDateTimePattern	гггг'-'мм'-'дд чч':'мм':'сс'Z'

Строки стандартного формата также можно использовать в операциях синтаксического анализа с методами DateTime.ParseExact и DateTimeOffset.ParseExact, которые требуют для успешного выполнения операции синтаксического анализа, чтобы входная строка строго соответствовала определенному шаблону. Многие строки стандартного формата сопоставляются с несколькими строками пользовательского формата, поэтому значение даты и времени может быть представлено в разных форматах, при этом операция синтаксического анализа пройдет успешно. Определить одну или несколько строк пользовательского формата, соответствующих строке стандартного формата, можно, вызвав метод DateTimeFormatInfo.GetAllDateTimePatterns(Char). В следующем примере показаны строки пользовательского формата, сопоставленные со строкой стандартного формата "d" (шаблон короткого формата даты).

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

В следующих разделах представлены описатели стандартных форматов для значений DateTime и DateTimeOffset.

Форматы даты

Эта группа содержит следующие форматы:

Описатель краткого формата даты ("d").
Описатель полного формата даты ("D").

Описатель короткого формата даты ("d")

Описатель стандартного формата "d" представляет строку настраиваемого формата даты и времени, определяемую свойством DateTimeFormatInfo.ShortDatePattern для конкретного языка и региональных параметров. Например, строкой настраиваемого формата, возвращаемой свойством ShortDatePattern для инвариантного языка и региональных параметров, будет строка "ММ/дд/гггг".

В следующей таблице представлены свойства объекта DateTimeFormatInfo, обеспечивающие управление форматированием возвращаемой строки.

Свойство.	Описание
ShortDatePattern	Определяет общий формат результирующей строки.
DateSeparator	Определяет строку, разделяющую компоненты даты — год, месяц и день.

В следующем примере описатель формата "d" используется для отображения значения даты и времени.

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

Свойство.	Описание
LongDatePattern	Определяет общий формат результирующей строки.
DayNames	Определяет переведенные названия дней, которые могут входить в результирующую строку.
MonthNames	Определяет переведенные названия месяцев, которые могут входить в результирующую строку.

Свойство.	Описание
LongDatePattern	Определяет формат компонента даты результирующей строки.
ShortTimePattern	Определяет формат компонента времени результирующей строки.
DayNames	Определяет переведенные названия дней, которые могут входить в результирующую строку.
MonthNames	Определяет переведенные названия месяцев, которые могут входить в результирующую строку.
TimeSeparator	Определяет строку, разделяющую компоненты времени — часы, минуты и секунды.
AMDesignator	Определяет строку, указывающую на время в интервале от полуночи до полудня в 12-часовом формате указания времени.
PMDesignator	Определяет строку, указывающую на время в интервале от полудня до полуночи в 12-часовом формате указания времени.

Свойство.	Описание
FullDateTimePattern	Определяет общий формат результирующей строки.
DayNames	Определяет переведенные названия дней, которые могут входить в результирующую строку.
MonthNames	Определяет переведенные названия месяцев, которые могут входить в результирующую строку.
TimeSeparator	Определяет строку, разделяющую компоненты времени — часы, минуты и секунды.
AMDesignator	Определяет строку, указывающую на время в интервале от полуночи до полудня в 12-часовом формате указания времени.
PMDesignator	Определяет строку, указывающую на время в интервале от полудня до полуночи в 12-часовом формате указания времени.

Свойство.	Описание
ShortDatePattern	Определяет формат компонента даты результирующей строки.
LongTimePattern	Определяет формат компонента времени результирующей строки.
DateSeparator	Определяет строку, разделяющую компоненты даты — год, месяц и день.
TimeSeparator	Определяет строку, разделяющую компоненты времени — часы, минуты и секунды.
AMDesignator	Определяет строку, указывающую на время в интервале от полуночи до полудня в 12-часовом формате указания времени.
PMDesignator	Определяет строку, указывающую на время в интервале от полудня до полуночи в 12-часовом формате указания времени.

Свойство.	Описание
RFC1123Pattern	Определяет формат результирующей строки.
AbbreviatedDayNames	Определяет сокращенные названия дней, которые могут входить в результирующую строку.
AbbreviatedMonthNames	Определяет сокращенные названия месяцев, которые могут входить в результирующую строку.

Свойство.	Описание
MonthDayPattern	Определяет общий формат результирующей строки.
MonthNames	Определяет переведенные названия месяцев, которые могут входить в результирующую строку.

Свойство.	Описание
YearMonthPattern	Определяет общий формат результирующей строки.
MonthNames	Определяет переведенные названия месяцев, которые могут входить в результирующую строку.

Строки стандартных форматов даты и времени

Таблица описателей формата

Как работают строки стандартного формата

Форматы даты

Описатель короткого формата даты ("d")

Описатель полного формата даты ("D")

Форматы даты и времени

Описатель полного формата даты и краткого формата времени ("f")

Описатель полного формата даты и полного формата времени ("F")

Описатель общего формата даты и краткого формата времени ("g")

Описатель общего формата даты и полного формата времени ("G")

Описатель формата обратного преобразования ("O", "o")

Описатель формата RFC1123 ("R", "r")

Описатель сортируемого формата ("s")

Описатель универсального сортируемого формата ("u")

Описатель универсального полного формата ("U")

Форматы времени

Описатель короткого формата времени ("t")

Описатель полного формата времени ("T")

Частичные форматы даты

Описатель формата месяца ("M", "m")

Описатель формата "год–месяц" ("Y", "y")

Параметры панели управления

Свойства DateTimeFormatInfo

См. также

Обратная связь

Дополнительные ресурсы