Chaînes de format de date et d’heure standard

Article
06/01/2023

Une chaîne de format de date et d’heure standard utilise un caractère unique comme spécificateur de format pour définir la représentation textuelle d’un DateTime ou d’une valeur de DateTimeOffset. Toute chaîne de format de date et d’heure contenant plusieurs caractères, y compris un espace blanc, est interprétée comme une chaîne de format de date et d’heure personnalisée. Une chaîne de format standard ou personnalisée peut être utilisée de deux façons :

Pour définir la chaîne qui résulte d'une opération de mise en forme.
Pour définir la représentation textuelle d'une valeur de date et d'heure pouvant être convertie en valeur DateTime ou en valeur DateTimeOffset lors d'une opération d'analyse.

Conseil

Vous pouvez télécharger l’utilitaire de mise en forme, application .NET Windows Forms qui vous permet d’appliquer des chaînes de mise en forme à des valeurs numériques ou à des valeurs de date et d’heure, et d’afficher la chaîne de résultat. Le code source est disponible pour C# et Visual Basic.

Notes

Certains exemples C# de cet article s’exécutent dans l’exécuteur et le terrain de jeu du code inline Try.NET. Sélectionnez le bouton Exécuter pour exécuter un exemple dans une fenêtre interactive. Une fois que vous avez exécuté le code, vous pouvez le modifier et exécuter le code modifié en resélectionnant Exécuter. La code modifié s’exécute dans la fenêtre interactive ou, si la compilation échoue, la fenêtre interactive affiche tous les messages d’erreur du compilateur C#.

Le fuseau horaire local de l’exécuteur de code en ligne et du terrain de jeu inline Try.NET est le temps universel coordonné, ou UTC. Cela peut affecter le comportement et la sortie d’exemples qui illustrent les types DateTime, DateTimeOffset et TimeZoneInfo ainsi que leurs membres.

Tableau de spécificateurs de format

Le tableau suivant décrit les spécificateurs de format de date et d’heure standard. Sauf indication contraire, un spécificateur de format de date et d'heure standard particulier produit une représentation sous forme de chaîne identique, qu'il soit utilisé avec une valeur DateTime ou DateTimeOffset. Pour plus d’informations sur l’utilisation de chaînes de format de date et d’heure standard, consultez Paramètres du panneau de configuration et Propriétés DateTimeFormatInfo.

Spécificateur de format	Description	Exemples
"d"	Modèle de date courte. Informations supplémentaires :Spécificateur de format de date courte ("d").	2009-06-15T13:45:30 -> 6/15/2009 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
« D »	Modèle de date longue. Informations supplémentaires :Spécificateur de format de date longue ("D").	2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f"	Modèle de date/heure complet (heure courte). Informations supplémentaires : Spécificateur de format de date complet et d’heure courte ("f").	2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F"	Modèle de date/heure complet (heure longue). Informations supplémentaires : Spécificateur de format de date complet et d’heure longue ("F").	2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g"	Modèle de date/heure général (heure courte). Informations supplémentaires : Spécificateur de format de date général et d’heure courte ("g").	2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	Modèle de date/heure général (heure longue). Informations supplémentaires : Spécificateur de format de date général et d’heure longue ("G").	2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m"	Modèle de mois/jour. Informations supplémentaires : Spécificateur de format de mois ("M", "m).	2009-06-15T13:45:30 -> June 15 (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o"	Modèle de date/heure aller-retour. Informations supplémentaires : Spécificateur de format aller-retour ("O", "o" »).	Valeurs DateTime : 2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:00 2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z 2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000 Valeurs DateTimeOffset : 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
"R", "r"	Modèle RFC1123. Informations supplémentaires : Spécificateur de format RFC1123 ("R", "r").	DateTimeOffset input: 2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT DateTime input: 2009-06-15T13:45:30 -> Mon, 15 Jun 2009 13:45:30 GMT
"s"	Modèle de date/heure pouvant être trié. Informations supplémentaires : Spécificateur de format pouvant être trié ("s").	2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30 2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
"t"	Modèle d’heure courte. Informations supplémentaires : Spécificateur de format d’heure courte ("t").	2009-06-15T13:45:30 -> 1:45 PM (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	Modèle d’heure longue. Informations supplémentaires : Spécificateur de format d’heure longue ("T").	2009-06-15T13:45:30 -> 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u"	Modèle de date/heure universel pouvant être trié. Informations supplémentaires : Spécificateur de format universel pouvant être trié ("u").	With a DateTime value: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z With a DateTimeOffset value: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Modèle de date/heure complet universel. Informations supplémentaires : Spécificateur de format complet universel ("U").	2009-06-15T13:45:30 -> Monday, June 15, 2009 8:45:30 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 20:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
"Y", "y"	Modèle d’année/mois. Informations supplémentaires : Spécificateur de format Année Mois ("Y").	2009-06-15T13:45:30 -> June 2009 (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
N'importe quel caractère	Spécificateur inconnu.	Lève un FormatException runtime.

Fonctionnement des chaînes de format standard

Dans une opération de mise en forme, une chaîne de format standard constitue simplement un alias d'une chaîne de format personnalisée. L'utilisation d'un alias pour faire référence à une chaîne de format personnalisée présente l'avantage suivant : bien que l'alias reste invariant, la chaîne de format personnalisée peut varier. Ce point est important car les représentations sous forme de chaîne de valeurs de date et d'heure varient généralement selon la culture. Par exemple, la chaîne de format standard "d" indique qu'une valeur de date et d'heure sera affichée à l'aide d'un modèle de date courte. Pour la culture dite indifférente, ce modèle est "MM/dd/yyyy". Pour la culture fr-FR, il s'agit de "dd/MM/yyyy". Pour la culture ja-JP, il s'agit de "yyyy/MM/dd".

Si, dans une opération de mise en forme, une chaîne de format standard est mappée à une chaîne de format personnalisée d'une culture particulière, votre application peut définir la culture spécifique dont les chaînes de format personnalisées sont utilisées de l'une des manières suivantes :

Vous pouvez utiliser la culture par défaut (ou actuelle). L'exemple suivant affiche une date à l'aide du format de date courte de la culture actuelle. Dans ce cas, la culture actuelle est en-US.

// Display using current (en-us) culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
Console.WriteLine(thisDate.ToString("d"));           // Displays 3/15/2008

' Display using current (en-us) culture's short date format
Dim thisDate As Date = #03/15/2008#
Console.WriteLine(thisDate.ToString("d"))     ' Displays 3/15/2008

Vous pouvez passer un objet CultureInfo représentant la culture dont la mise en forme sera utilisée à une méthode qui a un paramètre IFormatProvider. L'exemple suivant affiche une date à l'aide du format de date courte de la culture pt-BR.

// Display using pt-BR culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
CultureInfo culture = new CultureInfo("pt-BR");
Console.WriteLine(thisDate.ToString("d", culture));  // Displays 15/3/2008

' Display using pt-BR culture's short date format
Dim thisDate As Date = #03/15/2008#
Dim culture As New CultureInfo("pt-BR")
Console.WriteLine(thisDate.ToString("d", culture))   ' Displays 15/3/2008

Vous pouvez passer un objet DateTimeFormatInfo qui fournit des informations de mise en forme à une méthode qui a un paramètre IFormatProvider. L'exemple suivant affiche une date à l'aide du format de date courte d'un objet DateTimeFormatInfo pour la culture hr-HR.

// Display using date format information from hr-HR culture
DateTime thisDate = new DateTime(2008, 3, 15);
DateTimeFormatInfo fmt = (new CultureInfo("hr-HR")).DateTimeFormat;
Console.WriteLine(thisDate.ToString("d", fmt));      // Displays 15.3.2008

' Display using date format information from hr-HR culture
Dim thisDate As Date = #03/15/2008#
Dim fmt As DateTimeFormatInfo = (New CultureInfo("hr-HR")).DateTimeFormat
Console.WriteLine(thisDate.ToString("d", fmt))   ' Displays 15.3.2008

Notes

Pour plus d'informations sur la personnalisation des chaînes ou des modèles utilisés dans la mise en forme des valeurs numériques, consultez la rubrique de la classe NumberFormatInfo.

Dans certains cas, il est pratique d'utiliser la chaîne de format standard comme abréviation pour les chaînes de format personnalisées plus longues et indifférentes. Quatre chaînes de format standard appartiennent à cette catégorie : "O" (ou "o"), "R" (ou "r"), "s" et "u". Ces chaînes correspondent aux chaînes de format personnalisées définies par la culture dite indifférente. Elles produisent des représentations sous forme de chaîne de valeurs de date et d'heure destinées à être identiques dans toutes les cultures. Le tableau suivant fournit des informations sur ces quatre chaînes de format de date et d'heure standard.

Chaîne de format standard	Défini par la propriété DateTimeFormatInfo.InvariantInfo	Chaîne de format personnalisée
"O" ou "o"	None	yyyy’-’MM’-’dd’T’HH’ :’mm’ :’ss’.’fffffffK
"R" ou "r"	RFC1123Pattern	ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s"	SortableDateTimePattern	yyyy'-'MM'-'dd'T'HH':'mm':'ss
"u"	UniversalSortableDateTimePattern	yyyy'-'MM'-'dd HH':'mm':'ss'Z'

Les chaînes de format standard peuvent également utilisées dans les opérations d'analyses avec les méthodes DateTime.ParseExact ou DateTimeOffset.ParseExact. Pour que l'opération d'analyse aboutisse, ces méthodes requièrent qu'une chaîne d'entrée se conforme exactement à un modèle particulier. De nombreuses chaînes de format standard peuvent être mappées à plusieurs chaînes de format personnalisées, afin qu'une valeur de date et d'heure puisse être représentée dans divers formats et que l'opération d'analyse puisse continuer à aboutir. Vous pouvez déterminer les chaînes de format personnalisées qui correspondent à une chaîne de format standard en appelant la méthode DateTimeFormatInfo.GetAllDateTimePatterns(Char). L’exemple suivant affiche les chaînes de format personnalisées qui sont mappées à la chaîne de format standard « d » (modèle de date courte).

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("'d' standard format string:");
      foreach (var customString in DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns('d'))
          Console.WriteLine("   {0}", customString);
   }
}
// The example displays the following output:
//       'd' standard format string:
//          M/d/yyyy
//          M/d/yy
//          MM/dd/yy
//          MM/dd/yyyy
//          yy/MM/dd
//          yyyy-MM-dd
//          dd-MMM-yy

Imports System.Globalization

Module Example
    Public Sub Main()
        Console.WriteLine("'d' standard format string:")
        For Each customString In DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns("d"c)
            Console.WriteLine("   {0}", customString)
        Next
    End Sub
End Module
' The example displays the following output:
'    'd' standard format string:
'       M/d/yyyy
'       M/d/yy
'       MM/dd/yy
'       MM/dd/yyyy
'       yy/MM/dd
'       yyyy-MM-dd
'       dd-MMM-yy

Les sections suivantes décrivent les spécificateurs de format standard pour les valeurs DateTime et DateTimeOffset.

Formats de date

Ce groupe comprend les formats suivants :

Spécificateur de format de date courte ("d")
Spécificateur de format de date longue ("D")

Spécificateur de format de date courte ("d")

Le spécificateur de format standard "d" représente une chaîne de format de date et d'heure personnalisée définie par la propriété DateTimeFormatInfo.ShortDatePattern d'une culture spécifique. Par exemple, la chaîne de format personnalisée qui est retournée par la propriété ShortDatePattern de la culture dite indifférente est "MM/dd/yyyy".

Le tableau suivant répertorie les propriétés de l'objet DateTimeFormatInfo qui contrôlent la mise en forme de la chaîne retournée.

Propriété	Description
ShortDatePattern	Définit le format global de la chaîne de résultat.
DateSeparator	Définit la chaîne qui sépare les composants « année », « mois » et « jour » d'une date.

L'exemple suivant utilise le spécificateur de format "d" pour afficher une valeur de date et d'heure.

DateTime date1 = new DateTime(2008,4, 10);
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays 4/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-NZ")));
// Displays 10/04/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("de-DE")));
// Displays 10.04.2008

Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays 4/10/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-NZ")))
' Displays 10/04/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("de-DE")))
' Displays 10.04.2008

Propriété	Description
LongDatePattern	Définit le format global de la chaîne de résultat.
DayNames	Définit les noms de jours localisés qui peuvent apparaître dans la chaîne de résultat.
MonthNames	Définit les noms de mois localisés qui peuvent apparaître dans la chaîne de résultat.

Propriété	Description
LongDatePattern	Définit le format du composant « date » de la chaîne de résultat.
ShortTimePattern	Définit le format du composant « heure » de la chaîne de résultat.
DayNames	Définit les noms de jours localisés qui peuvent apparaître dans la chaîne de résultat.
MonthNames	Définit les noms de mois localisés qui peuvent apparaître dans la chaîne de résultat.
TimeSeparator	Définit la chaîne qui sépare les composants « heure », « minute » et « seconde » d'une heure.
AMDesignator	Définit la chaîne qui indique les heures de minuit à avant midi sur une horloge au format 12 heures.
PMDesignator	Définit la chaîne qui indique les heures de midi à avant minuit sur une horloge au format 12 heures.

Propriété	Description
FullDateTimePattern	Définit le format global de la chaîne de résultat.
DayNames	Définit les noms de jours localisés qui peuvent apparaître dans la chaîne de résultat.
MonthNames	Définit les noms de mois localisés qui peuvent apparaître dans la chaîne de résultat.
TimeSeparator	Définit la chaîne qui sépare les composants « heure », « minute » et « seconde » d'une heure.
AMDesignator	Définit la chaîne qui indique les heures de minuit à avant midi sur une horloge au format 12 heures.
PMDesignator	Définit la chaîne qui indique les heures de midi à avant minuit sur une horloge au format 12 heures.

Propriété	Description
ShortDatePattern	Définit le format du composant « date » de la chaîne de résultat.
LongTimePattern	Définit le format du composant « heure » de la chaîne de résultat.
DateSeparator	Définit la chaîne qui sépare les composants « année », « mois » et « jour » d'une date.
TimeSeparator	Définit la chaîne qui sépare les composants « heure », « minute » et « seconde » d'une heure.
AMDesignator	Définit la chaîne qui indique les heures de minuit à avant midi sur une horloge au format 12 heures.
PMDesignator	Définit la chaîne qui indique les heures de midi à avant minuit sur une horloge au format 12 heures.

Propriété	Description
RFC1123Pattern	Définit le format de la chaîne de résultat.
AbbreviatedDayNames	Définit les noms de jours abrégés qui peuvent s'afficher dans la chaîne de résultat.
AbbreviatedMonthNames	Définit les noms de mois abrégés qui peuvent s'afficher dans la chaîne de résultat.

Propriété	Description
MonthDayPattern	Définit le format global de la chaîne de résultat.
MonthNames	Définit les noms de mois localisés qui peuvent apparaître dans la chaîne de résultat.

Propriété	Description
YearMonthPattern	Définit le format global de la chaîne de résultat.
MonthNames	Définit les noms de mois localisés qui peuvent apparaître dans la chaîne de résultat.

Partager via

Chaînes de format de date et d’heure standard

Tableau de spécificateurs de format

Fonctionnement des chaînes de format standard

Formats de date

Spécificateur de format de date courte ("d")

Spécificateur de format de date longue ("D")

Formats de date et d’heure

Spécificateur de format de date complet et d’heure courte ("f")

Spécificateur de format de date complet et d’heure longue ("F")

Spécificateur de format de date général et d’heure courte ("g")

Spécificateur de format de date général et d’heure longue ("G")

Spécificateur de format aller-retour ("O", "o")

Spécificateur de format RFC1123 ("R", "r")

Spécificateur de format pouvant être trié ("s")

Spécificateur de format universel pouvant être trié ("u")

Spécificateur de format complet universel ("U")

Formats d’horodatage

Spécificateur de format d’heure courte ("t")

Spécificateur de format d’heure longue ("T")

Formats de date partielle

Spécificateur de format de mois ("M", "m")

Spécificateur de format Année Mois ("Y", "y")

Paramètres du panneau de configuration

Propriétés DateTimeFormatInfo

Voir aussi

Ressources supplémentaires