Partager via


DateTime.GetDateTimeFormats Méthode

Définition

Convertit la valeur de cette instance en toutes les représentations sous forme de chaîne prises en charge par les spécificateurs de format de date et d'heure standard.

Surcharges

GetDateTimeFormats()

Convertit la valeur de cette instance en toutes les représentations sous forme de chaîne prises en charge par les spécificateurs de format de date et d'heure standard.

GetDateTimeFormats(Char)

Convertit la valeur de cette instance en toutes les représentations sous forme de chaîne prises en charge par le spécificateur de format de date et d'heure standard spécifié.

GetDateTimeFormats(IFormatProvider)

Convertit la valeur de cette instance en toutes les représentations sous forme de chaîne prises en charge par les spécificateurs de format de date et d'heure standard spécifié et les données de format propres à la culture spécifiées.

GetDateTimeFormats(Char, IFormatProvider)

Convertit la valeur de cette instance en toutes les représentations sous forme de chaîne prises en charge par le spécificateur de format de date et d'heure standard spécifié et les données de format propres à la culture.

Remarques

Important

Vous ne devez pas supposer que plusieurs appels aux GetDateTimeFormats surcharges renverront des données identiques. En fonction de la surcharge spécifique, les données retournées par cette méthode peuvent changer si la culture actuelle change, si l’utilisateur remplace des paramètres culturels individuels ou si une mise à jour se produit dans les données culturelles du système.

GetDateTimeFormats()

Convertit la valeur de cette instance en toutes les représentations sous forme de chaîne prises en charge par les spécificateurs de format de date et d'heure standard.

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

Retours

String[]

Tableau de chaînes dont chaque élément est la représentation de la valeur de cette instance, mise en forme à l'aide d'un des spécificateurs de format de date et d'heure standard.

Exemples

L’exemple suivant illustre la DateTime.GetDateTimeFormats() méthode. Il affiche la représentation sous forme de chaîne d’une date à l’aide de tous les formats de date et d’heure standard possibles dans la culture actuelle de l’ordinateur, en l’occurrence 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

L’exemple affiche la sortie suivante :

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

Remarques

Le tableau de chaînes retourné par la DateTime.GetDateTimeFormats() méthode équivaut à combiner les tableaux de chaînes retournés par des appels séparés à la DateTime.GetDateTimeFormats(Char) méthode avec le « d », « d », « f », « f », « g », « g », « m », « o », « r », « s », « t », « t », « u », « u » et « y » chaînes de format standard. Pour plus d’informations sur les spécificateurs de format standard, consultez chaînes de format de date et d’heure standard.

Chaque élément de la valeur de retour est mis en forme à l’aide des informations de la culture actuelle. Pour plus d’informations sur les informations de mise en forme propres à la culture pour la culture actuelle, consultez CultureInfo.CurrentCulture .

Important

Étant donné que cette méthode utilise des données dépendantes de la culture, vous ne devez pas supposer que plusieurs appels à la méthode retournent des données identiques. Les données retournées par cette méthode peuvent changer si la culture actuelle change, si l’utilisateur remplace des paramètres culturels individuels ou si une mise à jour se produit dans les données culturelles du système.

Voir aussi

S’applique à

GetDateTimeFormats(Char)

Convertit la valeur de cette instance en toutes les représentations sous forme de chaîne prises en charge par le spécificateur de format de date et d'heure standard spécifié.

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

Paramètres

format
Char

Chaîne de format de date et d’heure standard.

Retours

String[]

Tableau de chaînes dont chaque élément est la représentation de la valeur de cette instance mise en forme à l'aide du spécificateur de format de date et d'heure standard format.

Exceptions

format n’est pas un caractère spécificateur de format de date et d’heure standard valide.

Exemples

L’exemple suivant illustre la GetDateTimeFormats(Char) méthode. Elle affiche la représentation sous forme de chaîne d’une date à l’aide du spécificateur de format de date longue ("D") pour la culture actuelle.

  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

Remarques

Le format paramètre peut être l’un des spécificateurs de format de date et d’heure standard. Il s’agit notamment d, D, f, F, g, G, M (ou m), O (ou o), R (ou r), s, t, T, u, U et Y (ou y). Pour plus d’informations, consultez chaînes de format de date et d’heure standard.

Chaque élément de la valeur de retour est mis en forme à l’aide des informations de la culture actuelle. Pour plus d’informations sur les informations de mise en forme propres à la culture pour la culture actuelle, consultez CultureInfo.CurrentCulture .

Important

Étant donné que cette méthode utilise des données dépendantes de la culture, vous ne devez pas supposer que plusieurs appels à la méthode retournent des données identiques. Les données retournées par cette méthode peuvent changer si la culture actuelle change, si l’utilisateur remplace des paramètres culturels individuels ou si une mise à jour se produit dans les données culturelles du système.

Voir aussi

S’applique à

GetDateTimeFormats(IFormatProvider)

Convertit la valeur de cette instance en toutes les représentations sous forme de chaîne prises en charge par les spécificateurs de format de date et d'heure standard spécifié et les données de format propres à la culture spécifiées.

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

Paramètres

provider
IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture se rapportant à cette instance.

Retours

String[]

Tableau de chaînes dont chaque élément est la représentation de la valeur de cette instance, mise en forme à l'aide d'un des spécificateurs de format de date et d'heure standard.

Exemples

L’exemple suivant illustre la DateTime.GetDateTimeFormats(IFormatProvider) méthode. Elle affiche la représentation sous forme de chaîne d’une date à l’aide de tous les formats de date et d’heure standard possibles pour la culture 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

L’exemple affiche la sortie suivante :

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

Remarques

Le tableau de chaînes retourné par la DateTime.GetDateTimeFormats(IFormatProvider) méthode équivaut à combiner les tableaux de chaînes retournés par des appels séparés à la DateTime.GetDateTimeFormats(Char, IFormatProvider) méthode avec le « d », « d », « f », « f », « g », « g », « m », « o », « r », « s », « t », « t », « u », « u » et « y » chaînes de format standard. Pour plus d’informations sur les spécificateurs de format standard, consultez chaînes de format de date et d’heure standard.

Chaque élément de la valeur de retour est mis en forme à l’aide des informations spécifiques à la culture fournies par provider .

Important

Étant donné que cette méthode utilise des données dépendantes de la culture, vous ne devez pas supposer que plusieurs appels à la méthode retournent des données identiques, sauf si provider est un CultureInfo objet qui représente la culture dite indifférente. Les données retournées par cette méthode peuvent changer si l’utilisateur remplace les paramètres culturels individuels de provider ou si une mise à jour se produit dans les données culturelles du système pour provider .

Voir aussi

S’applique à

GetDateTimeFormats(Char, IFormatProvider)

Convertit la valeur de cette instance en toutes les représentations sous forme de chaîne prises en charge par le spécificateur de format de date et d'heure standard spécifié et les données de format propres à la culture.

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

Paramètres

format
Char

Chaîne de format de date et d’heure.

provider
IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture se rapportant à cette instance.

Retours

String[]

Tableau de chaînes dont chaque élément est la représentation de la valeur de cette instance, mise en forme à l'aide d'un des spécificateurs de format de date et d'heure standard.

Exceptions

format n’est pas un caractère spécificateur de format de date et d’heure standard valide.

Exemples

L’exemple suivant illustre la GetDateTimeFormats(Char, IFormatProvider) méthode. Elle affiche les représentations sous forme de chaîne d’une date à l’aide du spécificateur de format de date abrégée ("d") pour la culture 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

Remarques

Le paramètre de format peut être l’un des spécificateurs de format de date et d’heure standard. Il s’agit notamment d, D, f, F, g, G, M (ou m), O (ou o), R (ou r), s, t, T, u, U et Y (ou y). Pour plus d’informations, consultez chaînes de format de date et d’heure standard.

Chaque élément de la valeur de retour est mis en forme à l’aide des informations spécifiques à la culture fournies par provider .

Important

Étant donné que cette méthode utilise des données dépendantes de la culture, vous ne devez pas supposer que plusieurs appels à la méthode retournent des données identiques, sauf si provider est un CultureInfo objet qui représente la culture dite indifférente. Les données retournées par cette méthode peuvent changer si l’utilisateur remplace les paramètres culturels individuels de provider ou si une mise à jour se produit dans les données culturelles du système pour provider .

Voir aussi

S’applique à