DateTime.GetDateTimeFormats Metoda

Reference

Definice

Obor názvů:: System

Sestavení:: System.Runtime.dll

Sestavení:: netstandard.dll

Sestavení:: mscorlib.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Převede hodnotu této instance na všechny řetězcové reprezentace podporované specifikátory standardního formátu data a času.

Přetížení

GetDateTimeFormats()	Převede hodnotu této instance na všechny řetězcové reprezentace podporované specifikátory standardního formátu data a času.
GetDateTimeFormats(Char)	Převede hodnotu této instance na všechny řetězcové reprezentace podporované zadaným specifikátorem standardního formátu data a času.
GetDateTimeFormats(IFormatProvider)	Převede hodnotu této instance na všechny řetězcové reprezentace podporované specifikátory standardního formátu data a času a zadané informace o formátování specifické pro jazykovou verzi.
GetDateTimeFormats(Char, IFormatProvider)	Převede hodnotu této instance na všechny řetězcové reprezentace podporované zadaným standardním specifikátorem formátu data a času a informace o formátování specifické pro jazykovou verzi.

Poznámky

Důležité

Nemělo by se předpokládat, že vícenásobná volání GetDateTimeFormats přetížení vrátí stejná data. V závislosti na konkrétním přetížení se data vrácená touto metodou můžou změnit, pokud se změní aktuální jazyková verze, uživatel přepíše jednotlivá kulturní nastavení nebo dojde k aktualizaci na kulturní data systému.

GetDateTimeFormats()

Převede hodnotu této instance na všechny řetězcové reprezentace podporované specifikátory standardního formátu data a času.

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

public string[] GetDateTimeFormats ();

member this.GetDateTimeFormats : unit -> string[]

Public Function GetDateTimeFormats () As String()

Návraty

String[]

Pole řetězců, kde je každý prvek reprezentace hodnoty této instance formátované pomocí jednoho ze standardních specifikátorů formátu data a času.

Příklady

Následující příklad ukazuje DateTime.GetDateTimeFormats() metodu. Zobrazuje řetězcové vyjádření data pomocí všech možných standardních formátů data a času v aktuální jazykové verzi počítače, což je v tomto případě 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

V příkladu se zobrazí následující výstup:

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

Poznámky

Pole řetězců vrácené DateTime.GetDateTimeFormats() metodou je ekvivalentem kombinování řetězcových polí vrácených samostatným voláním DateTime.GetDateTimeFormats(Char) metody s "d", "d", "f", "f", "g", "g", "m", "o", "r", "s", "t", "t", "u", "u" a "y" standardní formátovací řetězce. Další informace o specifikátorech standardního formátu naleznete v tématu standardní formátovací řetězce data a času.

Každý prvek návratové hodnoty je formátován pomocí informací z aktuální jazykové verze. Další informace o formátování informací specifických pro jazykovou verzi pro aktuální jazykovou verzi naleznete v tématu CultureInfo.CurrentCulture .

Důležité

Vzhledem k tomu, že tato metoda používá data závislá na jazykové verzi, neměli byste předpokládat, že vícenásobná volání metody vrátí shodná data. Data vrácená touto metodou se mohou změnit, pokud se změní aktuální jazyková verze, uživatel přepíše jednotlivá kulturní nastavení nebo dojde k aktualizaci kulturních dat systému.

Viz také

Standardní řetězce formátu data a času

Platí pro

GetDateTimeFormats(Char)

Převede hodnotu této instance na všechny řetězcové reprezentace podporované zadaným specifikátorem standardního formátu data a času.

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

Parametry

format: Char

Řetězec standardního formátu data a času.

Návraty

String[]

Pole řetězců, kde je každý prvek reprezentace hodnoty této instance formátované pomocí format standardního specifikátoru formátu data a času.

Výjimky

FormatException

format není platný standardní znak formátu data a času.

Příklady

Následující příklad ukazuje GetDateTimeFormats(Char) metodu. Zobrazuje řetězcové vyjádření data pomocí specifikátoru dlouhého formátu data ("D") pro aktuální jazykovou verzi.

  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

Poznámky

formatParametr může být libovolným specifikátorem standardního formátu data a času. Mezi ně patří d, D, f, F, g, G, M (nebo m), O (nebo O), R (nebo R), s, t, T, u, U a Y (nebo y). Další informace naleznete v tématu Standardní řetězce formátu data a času.

Důležité

Viz také

Standardní řetězce formátu data a času

Platí pro

GetDateTimeFormats(IFormatProvider)

Převede hodnotu této instance na všechny řetězcové reprezentace podporované specifikátory standardního formátu data a času a zadané informace o formátování specifické pro jazykovou verzi.

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

Parametry

provider: IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi k této instanci.

Návraty

String[]

Pole řetězců, kde je každý prvek reprezentace hodnoty této instance formátované pomocí jednoho ze standardních specifikátorů formátu data a času.

Příklady

Následující příklad ukazuje DateTime.GetDateTimeFormats(IFormatProvider) metodu. Zobrazuje řetězcové vyjádření data pomocí všech možných standardních formátů data a času pro jazykovou verzi 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

V příkladu se zobrazí následující výstup:

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

Poznámky

Pole řetězců vrácené DateTime.GetDateTimeFormats(IFormatProvider) metodou je ekvivalentem kombinování řetězcových polí vrácených samostatným voláním DateTime.GetDateTimeFormats(Char, IFormatProvider) metody s "d", "d", "f", "f", "g", "g", "m", "o", "r", "s", "t", "t", "u", "u" a "y" standardní formátovací řetězce. Další informace o specifikátorech standardního formátu naleznete v tématu standardní formátovací řetězce data a času.

Každý prvek návratové hodnoty je formátován pomocí informací specifických pro jazykovou verzi, které poskytuje provider .

Důležité

Vzhledem k tomu, že tato metoda používá data závislá na jazykové verzi, neměli byste předpokládat, že vícenásobná volání metody vrátí stejná data, pokud provider se nejedná o CultureInfo objekt, který představuje invariantní jazykovou verzi. Data vrácená touto metodou se můžou změnit, pokud uživatel přepíše individuální kulturní nastavení provider nebo pokud se k aktualizaci kulturních dat systému má k dispozici provider .

Viz také

Standardní řetězce formátu data a času

Platí pro

GetDateTimeFormats(Char, IFormatProvider)

Převede hodnotu této instance na všechny řetězcové reprezentace podporované zadaným standardním specifikátorem formátu data a času a informace o formátování specifické pro jazykovou verzi.

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

Parametry

format: Char

Řetězec formátu data a času.

provider: IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi k této instanci.

Návraty

String[]

Pole řetězců, kde je každý prvek reprezentace hodnoty této instance formátované pomocí jednoho ze standardních specifikátorů formátu data a času.

Výjimky

FormatException

format není platný standardní znak formátu data a času.

Příklady

Následující příklad ukazuje GetDateTimeFormats(Char, IFormatProvider) metodu. Zobrazuje řetězcové reprezentace data pomocí specifikátoru krátkého formátu data ("d") pro jazykovou verzi 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

Poznámky

Parametr format může být libovolným ze standardních specifikátorů formátu data a času. Mezi ně patří d, D, f, F, g, G, M (nebo m), O (nebo O), R (nebo R), s, t, T, u, U a Y (nebo y). Další informace naleznete v tématu Standardní řetězce formátu data a času.

Každý prvek návratové hodnoty je formátován pomocí informací specifických pro jazykovou verzi, které poskytuje provider .

Důležité

Viz také

Standardní řetězce formátu data a času

Platí pro

Sdílet prostřednictvím

DateTime.GetDateTimeFormats Metoda

Definice

Přetížení

Poznámky

GetDateTimeFormats()

Návraty

Příklady

Poznámky

Viz také

Platí pro

GetDateTimeFormats(Char)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

GetDateTimeFormats(IFormatProvider)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

GetDateTimeFormats(Char, IFormatProvider)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Další materiály