DateTime.GetDateTimeFormats Метод

Определение

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

Перегрузки

GetDateTimeFormats()

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

GetDateTimeFormats(Char)

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

GetDateTimeFormats(IFormatProvider)

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

GetDateTimeFormats(Char, IFormatProvider)

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

Комментарии

Важно!

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

GetDateTimeFormats()

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

public:
 cli::array <System::String ^> ^ GetDateTimeFormats();
public string[] GetDateTimeFormats ();
member this.GetDateTimeFormats : unit -> string[]
Public Function GetDateTimeFormats () As String()

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

String[]

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

Примеры

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

DateTime july28 = DateTime(2009, 7, 28, 5, 23, 15, 16);
array<String^>^july28Formats = july28.GetDateTimeFormats();

// Print [Out] july28* in all DateTime formats using the default culture.
System::Collections::IEnumerator^ myEnum = july28Formats->GetEnumerator();
while ( myEnum->MoveNext() )
{
   String^ format = safe_cast<String^>(myEnum->Current);
   System::Console::WriteLine( format );
}
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", "m", "o", "r", "s", "t", "t", "t", "u", "U" и "y". Дополнительные сведения об описателях стандартного формата см. в разделе "Строки стандартного формата даты и времени".

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

Важно!

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

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

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

GetDateTimeFormats(Char)

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

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.

Исключения

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). Дополнительные сведения см. в строках стандартного формата даты и времени.

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

Важно!

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

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

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

GetDateTimeFormats(IFormatProvider)

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

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.

DateTime juil28 = DateTime(2009, 7, 28, 5, 23, 15, 16);
IFormatProvider^ culture = gcnew System::Globalization::CultureInfo("fr-FR", true );

// Get the short date formats using the S"fr-FR" culture.
array<String^>^frenchJuly28Formats = juil28.GetDateTimeFormats(culture );

// Print [Out] july28* in all DateTime formats using fr-FR culture.
System::Collections::IEnumerator^ myEnum2 = frenchJuly28Formats->GetEnumerator();
while ( myEnum2->MoveNext() )
{
   String^ format = safe_cast<String^>(myEnum2->Current);
   System::Console::WriteLine(format );
}
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", "m", "o", "r", "s", "t", "t", "t", "u", "U" и "y". Дополнительные сведения об описателях стандартного формата см. в разделе "Строки стандартного формата даты и времени".

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

Важно!

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

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

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

GetDateTimeFormats(Char, IFormatProvider)

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

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[]

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

Исключения

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). Дополнительные сведения см. в строках стандартного формата даты и времени.

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

Важно!

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

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

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