DateTime.GetDateTimeFormats Метод

Определение

Пространство имен:: System

Сборки:: mscorlib.dll, System.Runtime.dll

Сборки:: netstandard.dll, System.Runtime.dll

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

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

Преобразует значение этого экземпляра во все строковые представления, поддерживаемые описателями стандартного формата даты и времени.

Перегрузки

Имя	Описание
GetDateTimeFormats()	Преобразует значение этого экземпляра во все строковые представления, поддерживаемые описателями стандартного формата даты и времени.
GetDateTimeFormats(Char)	Преобразует значение этого экземпляра во все строковые представления, поддерживаемые указанным описателям формата даты и времени.
GetDateTimeFormats(IFormatProvider)	Преобразует значение этого экземпляра во все строковые представления, поддерживаемые стандартными описателями формата даты и времени, и указанными сведениями о форматировании, зависящими от языка и региональных параметров.
GetDateTimeFormats(Char, IFormatProvider)	Преобразует значение этого экземпляра во все строковые представления, поддерживаемые указанным описательом формата даты и времени, а также сведениями о форматировании, зависящими от языка и региональных параметров.

Не следует предположить, что несколько вызовов GetDateTimeFormats перегрузки возвращают идентичные данные. В зависимости от конкретной перегрузки данные, возвращаемые этим методом, могут изменяться, если текущие региональные параметры изменяются, пользователь переопределяет отдельные региональные параметры или обновляет данные системы.

GetDateTimeFormats()

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

public:
 cli::array <System::String ^> ^ GetDateTimeFormats();

public string[] GetDateTimeFormats();

member this.GetDateTimeFormats : unit -> string[]

Public Function GetDateTimeFormats () As String()

Возвращаемое значение

String[]

Массив строк, в котором каждый элемент представляет значение этого экземпляра, отформатированного одним из стандартных описателей формата даты и времени.

Примеры

В следующем примере демонстрируется DateTime.GetDateTimeFormats() метод. В нем отображается строковое представление даты, используя все возможные стандартные форматы даты и времени в текущем языке и региональных параметрах компьютера, которые в данном случае en-US.

let july28 = DateTime(2009, 7, 28, 5, 23, 15, 16)

let july28Formats = july28.GetDateTimeFormats()

// Print out july28 in all DateTime formats using the default culture.
for format in july28Formats do
    printfn $"{format}"

DateTime july28 = new DateTime(2009, 7, 28, 5, 23, 15, 16);

string[] july28Formats = july28.GetDateTimeFormats();

// Print out july28 in all DateTime formats using the default culture.
foreach (string format in july28Formats) {
    Console.WriteLine(format);
}

Dim july28 As New DateTime(2009, 7, 28, 5, 23, 15, 16)
Dim july28Formats As String()
july28Formats = july28.GetDateTimeFormats()

' Print out july28 in all DateTime formats using the default culture.
For Each format As String In july28Formats
   Console.WriteLine(format)
Next

В примере отображаются следующие выходные данные:

7/28/2009
7/28/09
07/28/09
07/28/2009
09/07/28
2009-07-28
28-Jul-09
Tuesday, July 28, 2009
July 28, 2009
Tuesday, 28 July, 2009
28 July, 2009
Tuesday, July 28, 2009 5:23 AM
Tuesday, July 28, 2009 05:23 AM
Tuesday, July 28, 2009 5:23
Tuesday, July 28, 2009 05:23
July 28, 2009 5:23 AM
July 28, 2009 05:23 AM
July 28, 2009 5:23
July 28, 2009 05:23
Tuesday, 28 July, 2009 5:23 AM
Tuesday, 28 July, 2009 05:23 AM
Tuesday, 28 July, 2009 5:23
Tuesday, 28 July, 2009 05:23
28 July, 2009 5:23 AM
28 July, 2009 05:23 AM
28 July, 2009 5:23
28 July, 2009 05:23
Tuesday, July 28, 2009 5:23:15 AM
Tuesday, July 28, 2009 05:23:15 AM
Tuesday, July 28, 2009 5:23:15
Tuesday, July 28, 2009 05:23:15
July 28, 2009 5:23:15 AM
July 28, 2009 05:23:15 AM
July 28, 2009 5:23:15
July 28, 2009 05:23:15
Tuesday, 28 July, 2009 5:23:15 AM
Tuesday, 28 July, 2009 05:23:15 AM
Tuesday, 28 July, 2009 5:23:15
Tuesday, 28 July, 2009 05:23:15
28 July, 2009 5:23:15 AM
28 July, 2009 05:23:15 AM
28 July, 2009 5:23:15
28 July, 2009 05:23:15
7/28/2009 5:23 AM
7/28/2009 05:23 AM
7/28/2009 5:23
7/28/2009 05:23
7/28/09 5:23 AM
7/28/09 05:23 AM
7/28/09 5:23
7/28/09 05:23
07/28/09 5:23 AM
07/28/09 05:23 AM
07/28/09 5:23
07/28/09 05:23
07/28/2009 5:23 AM
07/28/2009 05:23 AM
07/28/2009 5:23
07/28/2009 05:23
09/07/28 5:23 AM
09/07/28 05:23 AM
09/07/28 5:23
09/07/28 05:23
2009-07-28 5:23 AM
2009-07-28 05:23 AM
2009-07-28 5:23
2009-07-28 05:23
28-Jul-09 5:23 AM
28-Jul-09 05:23 AM
28-Jul-09 5:23
28-Jul-09 05:23
7/28/2009 5:23:15 AM
7/28/2009 05:23:15 AM
7/28/2009 5:23:15
7/28/2009 05:23:15
7/28/09 5:23:15 AM
7/28/09 05:23:15 AM
7/28/09 5:23:15
7/28/09 05:23:15
07/28/09 5:23:15 AM
07/28/09 05:23:15 AM
07/28/09 5:23:15
07/28/09 05:23:15
07/28/2009 5:23:15 AM
07/28/2009 05:23:15 AM
07/28/2009 5:23:15
07/28/2009 05:23:15
09/07/28 5:23:15 AM
09/07/28 05:23:15 AM
09/07/28 5:23:15
09/07/28 05:23:15
2009-07-28 5:23:15 AM
2009-07-28 05:23:15 AM
2009-07-28 5:23:15
2009-07-28 05:23:15
28-Jul-09 5:23:15 AM
28-Jul-09 05:23:15 AM
28-Jul-09 5:23:15
28-Jul-09 05:23:15
July 28
July 28
2009-07-28T05:23:15.0160000
2009-07-28T05:23:15.0160000
Tue, 28 Jul 2009 05:23:15 GMT
Tue, 28 Jul 2009 05:23:15 GMT
2009-07-28T05:23:15
5:23 AM
05:23 AM
5:23
05:23
5:23:15 AM
05:23:15 AM
5:23:15
05:23:15
2009-07-28 05:23:15Z
Tuesday, July 28, 2009 12:23:15 PM
Tuesday, July 28, 2009 12:23:15 PM
Tuesday, July 28, 2009 12:23:15
Tuesday, July 28, 2009 12:23:15
July 28, 2009 12:23:15 PM
July 28, 2009 12:23:15 PM
July 28, 2009 12:23:15
July 28, 2009 12:23:15
Tuesday, 28 July, 2009 12:23:15 PM
Tuesday, 28 July, 2009 12:23:15 PM
Tuesday, 28 July, 2009 12:23:15
Tuesday, 28 July, 2009 12:23:15
28 July, 2009 12:23:15 PM
28 July, 2009 12:23:15 PM
28 July, 2009 12:23:15
28 July, 2009 12:23:15
July, 2009
July, 2009

Массив строк, возвращаемый DateTime.GetDateTimeFormats() методом, эквивалентен объединению строковых массивов, возвращаемых отдельными вызовами DateTime.GetDateTimeFormats(Char) метода с строками "d", "D", "f", "F", "G", "G", "G", "o", "r", "s", "t", "T", "U", "U" и "y" стандартных строк формата. Дополнительные сведения о описателях стандартного формата см. в разделе "Стандартные строки формата даты и времени".

Каждый элемент возвращаемого значения форматируется с использованием сведений из текущего языка и региональных параметров. Дополнительные сведения о форматировании с учетом языка и региональных параметров для текущего языка и региональных параметров см. в разделе CultureInfo.CurrentCulture.

Important

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

См. также раздел

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

Применяется к

GetDateTimeFormats(Char)

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

Преобразует значение этого экземпляра во все строковые представления, поддерживаемые указанным описателям формата даты и времени.

public:
 cli::array <System::String ^> ^ GetDateTimeFormats(char format);

public string[] GetDateTimeFormats(char format);

member this.GetDateTimeFormats : char -> string[]

Public Function GetDateTimeFormats (format As Char) As String()

Параметры

format: Char

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

Возвращаемое значение

String[]

Строковый массив, в котором каждый элемент представляет значение этого экземпляра, отформатированного с помощью стандартного format описателя формата даты и времени.

Исключения

FormatException

format не является допустимым символом описатель формата даты и времени стандартного формата.

Примеры

В следующем примере демонстрируется GetDateTimeFormats(Char) метод. В нем отображается строковое представление даты с помощью описателя формата длинной даты ("D") для текущего языка и региональных параметров.

let july28 = DateTime(2009, 7, 28, 5, 23, 15)

// Get the long date formats using the current culture.
let longJuly28Formats =
    july28.GetDateTimeFormats 'D'

// Display july28 in all long date formats.
for format in longJuly28Formats do
    printfn $"{format}"

// The example displays the following output:
//       Tuesday, July 28, 2009
//       July 28, 2009
//       Tuesday, 28 July, 2009
//       28 July, 2009

  DateTime july28 = new DateTime(2009, 7, 28, 5, 23, 15);
  
  // Get the long date formats using the current culture.
  string [] longJuly28Formats =
              july28.GetDateTimeFormats('D');

  // Display july28 in all long date formats.
  foreach (string format in longJuly28Formats) {
      Console.WriteLine(format);
  }
// The example displays the following output:
//       Tuesday, July 28, 2009
//       July 28, 2009
//       Tuesday, 28 July, 2009
//       28 July, 2009

  Dim july28 As Date = #7/28/2009 5:23:15#
  
  ' Get the long date formats using the current culture.
  Dim longJuly28Formats() As String = july28.GetDateTimeFormats("D"c)

  ' Display july28 in all long date formats.
  For Each format As String In longJuly28Formats
      Console.WriteLine(format)
Next			
' The example displays the following output:
'       Tuesday, July 28, 2009
'       July 28, 2009
'       Tuesday, 28 July, 2009
'       28 July, 2009

Параметр format может быть любым из стандартных описателей формата даты и времени. К ним относятся d, D, f, F, g, G, M (или m), O (или o), R (или r), s, t, T, U, U и Y (или y). Дополнительные сведения см. в разделе "Стандартные строки формата даты и времени".

Important

См. также раздел

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

Применяется к

GetDateTimeFormats(IFormatProvider)

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

Преобразует значение этого экземпляра во все строковые представления, поддерживаемые стандартными описателями формата даты и времени, и указанными сведениями о форматировании, зависящими от языка и региональных параметров.

public:
 cli::array <System::String ^> ^ GetDateTimeFormats(IFormatProvider ^ provider);

public string[] GetDateTimeFormats(IFormatProvider provider);

public string[] GetDateTimeFormats(IFormatProvider? provider);

member this.GetDateTimeFormats : IFormatProvider -> string[]

Public Function GetDateTimeFormats (provider As IFormatProvider) As String()

Параметры

provider: IFormatProvider

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

Возвращаемое значение

String[]

Примеры

В следующем примере демонстрируется DateTime.GetDateTimeFormats(IFormatProvider) метод. В нем отображается строковое представление даты, используя все возможные стандартные форматы даты и времени для языка и региональных параметров fr-FR.

let july28 = DateTime(2009, 7, 28, 5, 23, 15, 16)

let culture =
    System.Globalization.CultureInfo("fr-FR", true)

// Get the short date formats using the "fr-FR" culture.
let frenchJuly28Formats =
    july28.GetDateTimeFormats culture

// Display july28 in various formats using "fr-FR" culture.
for format in frenchJuly28Formats do
    printfn $"{format}"

DateTime july28 = new DateTime(2009, 7, 28, 5, 23, 15, 16);

IFormatProvider culture =
    new System.Globalization.CultureInfo("fr-FR", true);
// Get the short date formats using the "fr-FR" culture.
string [] frenchJuly28Formats =
            july28.GetDateTimeFormats(culture);

// Display july28 in various formats using "fr-FR" culture.
foreach (string format in frenchJuly28Formats) {
    Console.WriteLine(format);
}

Dim july28 As New DateTime(2009, 7, 28, 5, 23, 15, 16)
Dim culture As New System.Globalization.CultureInfo("fr-FR", True)

Dim july28Formats As String()
' Get the short date formats using the "fr-FR" culture.
july28Formats = july28.GetDateTimeFormats(culture)

' Print out july28 in various formats using "fr-FR" culture.
For Each format As String In july28Formats
   Console.WriteLine(format)
Next

В примере отображаются следующие выходные данные:

28/07/2009
28/07/09
28.07.09
28-07-09
2009-07-28
mardi 28 juillet 2009
28 juil. 09
28 juillet 2009
mardi 28 juillet 2009 05:23
mardi 28 juillet 2009 5:23
mardi 28 juillet 2009 05.23
mardi 28 juillet 2009 05 h 23
28 juil. 09 05:23
28 juil. 09 5:23
28 juil. 09 05.23
28 juil. 09 05 h 23
28 juillet 2009 05:23
28 juillet 2009 5:23
28 juillet 2009 05.23
28 juillet 2009 05 h 23
mardi 28 juillet 2009 05:23:15
mardi 28 juillet 2009 5:23:15
mardi 28 juillet 2009 05.23
mardi 28 juillet 2009 05 h 23
28 juil. 09 05:23:15
28 juil. 09 5:23:15
28 juil. 09 05.23
28 juil. 09 05 h 23
28 juillet 2009 05:23:15
28 juillet 2009 5:23:15
28 juillet 2009 05.23
28 juillet 2009 05 h 23
28/07/2009 05:23
28/07/2009 5:23
28/07/2009 05.23
28/07/2009 05 h 23
28/07/09 05:23
28/07/09 5:23
28/07/09 05.23
28/07/09 05 h 23
28.07.09 05:23
28.07.09 5:23
28.07.09 05.23
28.07.09 05 h 23
28-07-09 05:23
28-07-09 5:23
28-07-09 05.23
28-07-09 05 h 23
2009-07-28 05:23
2009-07-28 5:23
2009-07-28 05.23
2009-07-28 05 h 23
28/07/2009 05:23:15
28/07/2009 5:23:15
28/07/2009 05.23
28/07/2009 05 h 23
28/07/09 05:23:15
28/07/09 5:23:15
28/07/09 05.23
28/07/09 05 h 23
28.07.09 05:23:15
28.07.09 5:23:15
28.07.09 05.23
28.07.09 05 h 23
28-07-09 05:23:15
28-07-09 5:23:15
28-07-09 05.23
28-07-09 05 h 23
2009-07-28 05:23:15
2009-07-28 5:23:15
2009-07-28 05.23
2009-07-28 05 h 23
28 juillet
28 juillet
2009-07-28T05:23:15.0160000
2009-07-28T05:23:15.0160000
Tue, 28 Jul 2009 05:23:15 GMT
Tue, 28 Jul 2009 05:23:15 GMT
2009-07-28T05:23:15
05:23
5:23
05.23
05 h 23
05:23:15
5:23:15
05.23
05 h 23
2009-07-28 05:23:15Z
mardi 28 juillet 2009 12:23:15
mardi 28 juillet 2009 12:23:15
mardi 28 juillet 2009 12.23
mardi 28 juillet 2009 12 h 23
28 juil. 09 12:23:15
28 juil. 09 12:23:15
28 juil. 09 12.23
28 juil. 09 12 h 23
28 juillet 2009 12:23:15
28 juillet 2009 12:23:15
28 juillet 2009 12.23
28 juillet 2009 12 h 23
juillet 2009
juillet 2009

Массив строк, возвращаемый DateTime.GetDateTimeFormats(IFormatProvider) методом, эквивалентен объединению строковых массивов, возвращаемых отдельными вызовами DateTime.GetDateTimeFormats(Char, IFormatProvider) метода с строками "d", "D", "f", "F", "G", "G", "G", "o", "r", "s", "t", "T", "U", "U" и "y" стандартных строк формата. Дополнительные сведения о описателях стандартного формата см. в разделе "Стандартные строки формата даты и времени".

Каждый элемент возвращаемого значения форматируется с помощью сведений provider, относящихся к языку и региональных параметров.

Important

Так как этот метод использует конфиденциальные данные с учетом языка и региональных параметров, не следует предполагать, что несколько вызовов метода возвращают идентичные данные, если providerCultureInfo только объект, представляющий инвариантный язык и региональные параметры. Данные, возвращаемые этим методом, могут измениться, если пользователь переопределяет отдельные культурные параметры или происходит обновление в культурных provider данных системы.provider

См. также раздел

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

Применяется к

GetDateTimeFormats(Char, IFormatProvider)

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

Исходный код:: DateTime.cs

Преобразует значение этого экземпляра во все строковые представления, поддерживаемые указанным описательом формата даты и времени, а также сведениями о форматировании, зависящими от языка и региональных параметров.

public:
 cli::array <System::String ^> ^ GetDateTimeFormats(char format, IFormatProvider ^ provider);

public string[] GetDateTimeFormats(char format, IFormatProvider provider);

public string[] GetDateTimeFormats(char format, IFormatProvider? provider);

member this.GetDateTimeFormats : char * IFormatProvider -> string[]

Public Function GetDateTimeFormats (format As Char, provider As IFormatProvider) As String()

Параметры

format: Char

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

provider: IFormatProvider

Возвращаемое значение

String[]

Исключения

FormatException

format не является допустимым символом описатель формата даты и времени стандартного формата.

Примеры

В следующем примере демонстрируется GetDateTimeFormats(Char, IFormatProvider) метод. В нем отображаются строковые представления даты с помощью описателя формата короткой даты ("d") для языка и региональных параметров fr-FR.

let july28 = DateTime(2009, 7, 28, 5, 23, 15)

let culture =
    System.Globalization.CultureInfo("fr-FR", true)

// Get the short date formats using the "fr-FR" culture.
let frenchJuly28Formats =
    july28.GetDateTimeFormats('d', culture)

// Display july28 in short date formats using "fr-FR" culture.
for format in frenchJuly28Formats do
    printfn $"{format}"

// The example displays the following output:
//       28/07/2009
//       28/07/09
//       28.07.09
//       28-07-09
//       2009-07-28

  DateTime july28 = new DateTime(2009, 7, 28, 5, 23, 15);
  
  IFormatProvider culture =
      new System.Globalization.CultureInfo("fr-FR", true);
  // Get the short date formats using the "fr-FR" culture.
  string [] frenchJuly28Formats =
              july28.GetDateTimeFormats('d', culture);

  // Display july28 in short date formats using "fr-FR" culture.
  foreach (string format in frenchJuly28Formats) {
      Console.WriteLine(format);
  }
// The example displays the following output:
//       28/07/2009
//       28/07/09
//       28.07.09
//       28-07-09
//       2009-07-28

  Dim july28 As Date = #7/28/2009 5:23:15#
  
  Dim culture As IFormatProvider = New System.Globalization.CultureInfo("fr-FR", True)
  ' Get the short date formats using the "fr-FR" culture.
  Dim frenchJuly28Formats() As String = july28.GetDateTimeFormats("d"c, culture)

  ' Display july28 in short date formats using "fr-FR" culture.
  For Each format As String In frenchJuly28Formats
      Console.WriteLine(format)
  Next
' The example displays the following output:
'       28/07/2009
'       28/07/09
'       28.07.09
'       28-07-09
'       2009-07-28

Параметр формата может быть любым из стандартных описателей формата даты и времени. К ним относятся d, D, f, F, g, G, M (или m), O (или o), R (или r), s, t, T, U, U и Y (или y). Дополнительные сведения см. в разделе "Стандартные строки формата даты и времени".

Important

Так как этот метод использует конфиденциальные данные с учетом языка и региональных параметров, не следует предполагать, что несколько вызовов метода возвращают идентичные данные, если providerCultureInfo только объект, представляющий инвариантный язык и региональные параметры. Данные, возвращаемые этим методом, могут измениться, если пользователь переопределяет отдельные культурные параметры или происходит обновление в культурных provider данных системы.provider

См. также раздел

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

Применяется к

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

Были ли сведения на этой странице полезными?

DateTime.GetDateTimeFormats Метод

Определение

Перегрузки

Комментарии

GetDateTimeFormats()

Возвращаемое значение

Примеры

Комментарии

См. также раздел

Применяется к

GetDateTimeFormats(Char)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

GetDateTimeFormats(IFormatProvider)

Параметры

Возвращаемое значение

Примеры

Комментарии

См. также раздел

Применяется к

GetDateTimeFormats(Char, IFormatProvider)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к