DateTime.GetDateTimeFormats Método

  • Referência

Definição

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly:
mscorlib.dll

Converte o valor dessa instância em todas as representações de cadeia de caracteres com suporte nos especificadores de formato de data e hora padrão.

Sobrecargas

GetDateTimeFormats()

Converte o valor dessa instância em todas as representações de cadeia de caracteres com suporte nos especificadores de formato de data e hora padrão.
GetDateTimeFormats(Char)

Converte o valor dessa instância em todas as representações de cadeia de caracteres com suporte no especificador de formato de data e hora padrão especificado.
GetDateTimeFormats(IFormatProvider)

Converte o valor dessa instância para todas as representações de cadeia de caracteres com suporte pelos especificadores de formato de data e hora padrão e as informações de formatação específicas da cultura especificadas.
GetDateTimeFormats(Char, IFormatProvider)

Converte o valor dessa instância para todas as representações de cadeia de caracteres com suporte pelos especificadores de formato de data e hora e as informações de formatação específicas da cultura especificadas.

Comentários

Importante

Você não deve supor que várias chamadas para as GetDateTimeFormats sobrecargas retornarão dados idênticos. Dependendo da sobrecarga específica, os dados retornados por esse método poderão ser alterados se a cultura atual for alterada, o usuário substituirá as configurações culturais individuais ou uma atualização ocorrerá nos dados culturais do sistema.

GetDateTimeFormats()

Converte o valor dessa instância em todas as representações de cadeia de caracteres com suporte nos especificadores de formato de data e hora padrão.

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

Retornos

String[]

Uma matriz de cadeia de caracteres em que cada elemento é a representação do valor dessa instância formatada com um dos especificadores de formato de data e hora padrão.

Exemplos

O exemplo a seguir demonstra o DateTime.GetDateTimeFormats() método. Ele exibe a representação de cadeia de caracteres de uma data usando todos os formatos de data e hora padrão possíveis na cultura atual do computador, que nesse caso é 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 );
}

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

O exemplo exibe a seguinte saída:

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

Comentários

A matriz de cadeia de caracteres retornada pelo DateTime.GetDateTimeFormats() método é equivalente a combinar as matrizes de cadeia de caracteres retornadas por chamadas separadas para o DateTime.GetDateTimeFormats(Char) método com o "d", "d", "f", "f", "g", "g", "m", "o", "r", "s", "t", "t", "u", "u" e "y" cadeias de caracteres de formato padrão. Para obter mais informações sobre especificadores de formato padrão, consulte cadeias de caracteres de formato padrão de data e hora.

Cada elemento do valor de retorno é formatado usando as informações da cultura atual. Para obter mais informações sobre informações de formatação específicas de cultura para a cultura atual, consulte CultureInfo.CurrentCulture .

Importante

Como esse método usa dados sensíveis à cultura, você não deve presumir que várias chamadas para o método retornem dados idênticos. Os dados retornados por esse método podem mudar se a cultura atual for alterada, o usuário substituir configurações culturais individuais ou uma atualização ocorrer para os dados culturais do sistema.

Confira também

Aplica-se a

GetDateTimeFormats(Char)

Converte o valor dessa instância em todas as representações de cadeia de caracteres com suporte no especificador de formato de data e hora padrão especificado.

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()

Parâmetros

format
Char

Um cadeia de formato de data e hora padrão.

Retornos

String[]

Uma matriz de cadeia de caracteres em que cada elemento é a representação do valor dessa instância formatada com o especificador de formato de data e hora padrão format.

Exceções

FormatException

format não é um caractere especificador de formato de data e hora padrão válido.

Exemplos

O exemplo a seguir demonstra o GetDateTimeFormats(Char) método. Ele exibe a representação de cadeia de caracteres de uma data usando o especificador de formato de data por extenso ("D") para a cultura atual.

  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

Comentários

O format parâmetro pode ser qualquer um dos especificadores de formato de data e hora padrão. Isso inclui d, D, f, F, g, G, M (ou M), O (ou O), R (ou R), s, t, T, u, U e Y (ou y). Para obter mais informações, consulte cadeias de caracteres de formato padrão de data e hora.

Cada elemento do valor de retorno é formatado usando as informações da cultura atual. Para obter mais informações sobre informações de formatação específicas de cultura para a cultura atual, consulte CultureInfo.CurrentCulture .

Importante

Como esse método usa dados sensíveis à cultura, você não deve presumir que várias chamadas para o método retornem dados idênticos. Os dados retornados por esse método podem mudar se a cultura atual for alterada, o usuário substituir configurações culturais individuais ou uma atualização ocorrer para os dados culturais do sistema.

Confira também

Aplica-se a

GetDateTimeFormats(IFormatProvider)

Converte o valor dessa instância para todas as representações de cadeia de caracteres com suporte pelos especificadores de formato de data e hora padrão e as informações de formatação específicas da cultura especificadas.

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()

Parâmetros

provider
IFormatProvider

Um objeto que fornece informações de formatação específicas de cultura sobre essa instância.

Retornos

String[]

Uma matriz de cadeia de caracteres em que cada elemento é a representação do valor dessa instância formatada com um dos especificadores de formato de data e hora padrão.

Exemplos

O exemplo a seguir demonstra o DateTime.GetDateTimeFormats(IFormatProvider) método. Ele exibe a representação de cadeia de caracteres de uma data usando todos os formatos de data e hora padrão possíveis para a cultura 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 );
}

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

O exemplo exibe a seguinte saída:

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

Comentários

A matriz de cadeia de caracteres retornada pelo DateTime.GetDateTimeFormats(IFormatProvider) método é equivalente a combinar as matrizes de cadeia de caracteres retornadas por chamadas separadas para o DateTime.GetDateTimeFormats(Char, IFormatProvider) método com o "d", "d", "f", "f", "g", "g", "m", "o", "r", "s", "t", "t", "u", "u" e "y" cadeias de caracteres de formato padrão. Para obter mais informações sobre especificadores de formato padrão, consulte cadeias de caracteres de formato padrão de data e hora.

Cada elemento do valor de retorno é formatado usando informações específicas de cultura fornecidas pelo provider .

Importante

Como esse método usa dados sensíveis à cultura, você não deve presumir que várias chamadas para o método retornarão dados idênticos, a menos que provider seja um CultureInfo objeto que represente a cultura invariável. Os dados retornados por esse método podem ser alterados se o usuário substituir as configurações culturais individuais do provider ou se ocorrer uma atualização para os dados culturais do sistema para o provider .

Confira também

Aplica-se a

GetDateTimeFormats(Char, IFormatProvider)

Converte o valor dessa instância para todas as representações de cadeia de caracteres com suporte pelos especificadores de formato de data e hora e as informações de formatação específicas da cultura especificadas.

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()

Parâmetros

format
Char

Uma cadeia de formato de data e hora.

provider
IFormatProvider

Um objeto que fornece informações de formatação específicas de cultura sobre essa instância.

Retornos

String[]

Uma matriz de cadeia de caracteres em que cada elemento é a representação do valor dessa instância formatada com um dos especificadores de formato de data e hora padrão.

Exceções

FormatException

format não é um caractere especificador de formato de data e hora padrão válido.

Exemplos

O exemplo a seguir demonstra o GetDateTimeFormats(Char, IFormatProvider) método. Ele exibe as representações de cadeia de caracteres de uma data usando o especificador de formato de data abreviada ("d") para a cultura fr-FR.

  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

Comentários

O parâmetro format pode ser qualquer um dos especificadores de formato de data e hora padrão. Isso inclui d, D, f, F, g, G, M (ou M), O (ou O), R (ou R), s, t, T, u, U e Y (ou y). Para obter mais informações, consulte cadeias de caracteres de formato padrão de data e hora.

Cada elemento do valor de retorno é formatado usando informações específicas de cultura fornecidas pelo provider .

Importante

Como esse método usa dados sensíveis à cultura, você não deve presumir que várias chamadas para o método retornarão dados idênticos, a menos que provider seja um CultureInfo objeto que represente a cultura invariável. Os dados retornados por esse método podem ser alterados se o usuário substituir as configurações culturais individuais do provider ou se ocorrer uma atualização para os dados culturais do sistema para o provider .

Confira também

Aplica-se a