DateTime.GetDateTimeFormats Método

Definição

Espaço de Nomes:: System

Assemblagens:: mscorlib.dll, System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Converte o valor desta instância para todas as representações de cadeias suportadas pelos especificadores padrão de formato de data e hora.

Sobrecargas

Name	Description
GetDateTimeFormats()	Converte o valor desta instância para todas as representações de cadeias suportadas pelos especificadores padrão de formato de data e hora.
GetDateTimeFormats(Char)	Converte o valor desta instância para todas as representações de cadeias suportadas pelo especificador de formato padrão de data e hora.
GetDateTimeFormats(IFormatProvider)	Converte o valor desta instância para todas as representações de strings suportadas pelos especificadores padrão de formato de data e hora e pela informação de formatação específica da cultura.
GetDateTimeFormats(Char, IFormatProvider)	Converte o valor desta instância para todas as representações de strings suportadas pelo especificador de formato padrão de data e hora especificado e pela informação de formatação específica da cultura.

Observações

Importante

Não deve assumir que múltiplas chamadas às GetDateTimeFormats sobrecargas vão devolver dados idênticos. Dependendo da sobrecarga específica, os dados devolvidos por este método podem mudar se a cultura atual mudar, o utilizador sobrepor definições culturais individuais ou ocorrer uma atualização dos dados culturais do sistema.

GetDateTimeFormats()

Converte o valor desta instância para todas as representações de cadeias suportadas pelos especificadores padrão de formato de data e hora.

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

public string[] GetDateTimeFormats();

member this.GetDateTimeFormats : unit -> string[]

Public Function GetDateTimeFormats () As String()

Devoluções

String[]

Um array de string onde cada elemento representa o valor desta instância formatado com um dos especificadores padrão de data e hora.

Exemplos

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

O exemplo apresenta o seguinte resultado:

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

Observações

O array de strings devolvido pelo DateTime.GetDateTimeFormats() método é equivalente a combinar os arrays de strings devolvidos por chamadas separadas ao DateTime.GetDateTimeFormats(Char) método com as strings de formato padrão "d", "D", "F", "F", "g", "G", "m", "o", "r", "s", "t", "T", "u", "u" e "y". Para mais informações sobre especificadores de formato padrão, consulte Cadeias de Formato de Data e Hora Padrão.

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

Importante

Como este método utiliza dados sensíveis à cultura, não deve assumir que múltiplas chamadas ao método devolverão dados idênticos. Os dados devolvidos por este método podem mudar se a cultura atual mudar, o utilizador sobrepor configurações culturais individuais ou ocorrer uma atualização dos dados culturais do sistema.

Ver também

Cadeias de Formatos de Data e Hora Padrão

Aplica-se a

GetDateTimeFormats(Char)

Converte o valor desta instância para todas as representações de cadeias suportadas pelo especificador de formato padrão de data e hora.

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

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

Devoluções

String[]

Um array de cadeias onde cada elemento representa o valor desta instância, formatado com o format especificador padrão de data e hora.

Exceções

FormatException

format não é um carácter válido para o formato de data e hora.

Exemplos

O exemplo seguinte demonstra o GetDateTimeFormats(Char) método. Apresenta a representação em cadeia de uma data usando o especificador de formato de data longa ("D") para a cultura atual.

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

Observações

O format parâmetro pode ser qualquer um dos especificadores padrão de formato de data e hora. Estes incluem 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 mais informações, consulte Cadeias de Formato Padrão de Data e Hora.

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

Importante

Ver também

Cadeias de Formatos de Data e Hora Padrão

Aplica-se a

GetDateTimeFormats(IFormatProvider)

Converte o valor desta instância para todas as representações de strings suportadas pelos especificadores padrão de formato de data e hora e pela informação de formatação específica da cultura.

public:
 cli::array <System::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 forneça informação de formatação específica da cultura sobre este caso.

Devoluções

String[]

Um array de string onde cada elemento representa o valor desta instância formatado com um dos especificadores padrão de data e hora.

Exemplos

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

O exemplo apresenta o seguinte resultado:

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

Observações

O array de strings devolvido pelo DateTime.GetDateTimeFormats(IFormatProvider) método é equivalente a combinar os arrays de strings devolvidos por chamadas separadas ao DateTime.GetDateTimeFormats(Char, IFormatProvider) método com as strings de formato padrão "d", "D", "F", "F", "g", "G", "m", "o", "r", "s", "t", "T", "u", "u" e "y". Para mais informações sobre especificadores de formato padrão, consulte Cadeias de Formato de Data e Hora Padrão.

Cada elemento do valor de retorno é formatado usando informação específica da cultura fornecida por provider.

Importante

Como este método utiliza dados sensíveis à cultura, não se deve assumir que múltiplas chamadas ao método devolverão dados idênticos, a menos que provider seja um CultureInfo objeto que represente a cultura invariante. Os dados devolvidos por este método podem mudar se o utilizador sobrescrever as definições culturais individuais de provider ou se ocorrer uma atualização dos dados culturais do sistema para provider.

Ver também

Cadeias de Formatos de Data e Hora Padrão

Aplica-se a

GetDateTimeFormats(Char, IFormatProvider)

Converte o valor desta instância para todas as representações de strings suportadas pelo especificador de formato padrão de data e hora especificado e pela informação de formatação específica da cultura.

public:
 cli::array <System::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 sequência de formatos de data e hora.

provider: IFormatProvider

Um objeto que forneça informação de formatação específica da cultura sobre este caso.

Devoluções

String[]

Um array de string onde cada elemento representa o valor desta instância formatado com um dos especificadores padrão de data e hora.

Exceções

FormatException

format não é um carácter válido para o formato de data e hora.

Exemplos

O exemplo seguinte demonstra o GetDateTimeFormats(Char, IFormatProvider) método. Apresenta as representações das cadeias de uma data usando o especificador de formato de data curta ("d") para a cultura 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

Observações

O parâmetro de formato pode ser qualquer um dos especificadores padrão de data e hora. Estes incluem 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 mais informações, consulte Cadeias de Formato Padrão de Data e Hora.

Cada elemento do valor de retorno é formatado usando informação específica da cultura fornecida por provider.

Importante

Ver também

Cadeias de Formatos de Data e Hora Padrão

Aplica-se a

Comentários

Esta página foi útil?