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

Article
08/10/2011

Une chaîne de format de date et d'heure standard utilise un spécificateur de format unique pour définir la représentation textuelle d'une valeur de date et d'heure. 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. Pour plus d'informations, consultez Chaînes de format de date et d'heure personnalisées. 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.

Les chaînes de format de date et d'heure standard peuvent être utilisées avec les valeurs DateTime et DateTimeOffset.

Conseil
Vous pouvez télécharger l'application Format Utility (page éventuellement en anglais), qui vous permet d'appliquer des chaînes de format à des valeurs numériques ou de date et d'heure. Elle permet également d'afficher la chaîne de résultat.

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 la section Remarques.

Spécificateur de format	Description	Exemples
"d"	Modèle de date courte. Informations supplémentaires :Spécificateur de format de date courte ("d").	6/15/2009 1:45:30 PM -> 6/15/2009 (en-US) 6/15/2009 1:45:30 PM -> 15/06/2009 (fr-FR) 6/15/2009 1:45:30 PM -> 2009/06/15 (ja-JP)
"D"	Modèle de date longue. Informations supplémentaires :Spécificateur de format de date longue ("D").	6/15/2009 1:45:30 PM -> Monday, June 15, 2009 (en-US) 6/15/2009 1:45:30 PM -> 15 июня 2009 г. (ru-RU) 6/15/2009 1:45:30 PM -> 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").	6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45 PM (en-US) 6/15/2009 1:45:30 PM -> den 15 juni 2009 13:45 (sv-SE) 6/15/2009 1:45:30 PM -> Δευτέρα, 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").	6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45:30 PM (en-US) 6/15/2009 1:45:30 PM -> den 15 juni 2009 13:45:30 (sv-SE) 6/15/2009 1:45:30 PM -> Δευτέρα, 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").	6/15/2009 1:45:30 PM -> 6/15/2009 1:45 PM (en-US) 6/15/2009 1:45:30 PM -> 15/06/2009 13:45 (es-ES) 6/15/2009 1:45:30 PM -> 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").	6/15/2009 1:45:30 PM -> 6/15/2009 1:45:30 PM (en-US) 6/15/2009 1:45:30 PM -> 15/06/2009 13:45:30 (es-ES) 6/15/2009 1:45:30 PM -> 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").	6/15/2009 1:45:30 PM -> June 15 (en-US) 6/15/2009 1:45:30 PM -> 15. juni (da-DK) 6/15/2009 1:45:30 PM -> 15 Juni (id-ID)
"O", "o"	Modèle de date/heure aller-retour. Informations supplémentaires : Spécificateur de format aller-retour ("O", "o").	6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30.0900000
"R", "r"	Modèle RFC1123. Informations supplémentaires : Spécificateur de format RFC1123 ("R", "r").	6/15/2009 1:45:30 PM -> Mon, 15 Jun 2009 20:45:30 GMT
"s"	Modèle de date/heure pouvant être trié. Informations supplémentaires : Spécificateur de format pouvant être trié ("s").	6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30
"t"	Modèle d'heure courte. Informations supplémentaires : Spécificateur de format d'heure courte ("t").	6/15/2009 1:45:30 PM -> 1:45 PM (en-US) 6/15/2009 1:45:30 PM -> 13:45 (hr-HR) 6/15/2009 1:45:30 PM -> 01:45 م (ar-EG)
"T"	Modèle d'heure longue. Informations supplémentaires : Spécificateur de format d'heure longue ("T").	6/15/2009 1:45:30 PM -> 1:45:30 PM (en-US) 6/15/2009 1:45:30 PM -> 13:45:30 (hr-HR) 6/15/2009 1:45:30 PM -> 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").	6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z
"U"	Modèle de date/heure complet universel. Informations supplémentaires : Spécificateur de format complet universel ("U").	6/15/2009 1:45:30 PM -> Monday, June 15, 2009 8:45:30 PM (en-US) 6/15/2009 1:45:30 PM -> den 15 juni 2009 20:45:30 (sv-SE) 6/15/2009 1:45:30 PM -> Δευτέρα, 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").	6/15/2009 1:45:30 PM -> June, 2009 (en-US) 6/15/2009 1:45:30 PM -> juni 2009 (da-DK) 6/15/2009 1:45:30 PM -> Juni 2009 (id-ID)
N'importe quel caractère	Spécificateur inconnu.	Lève un FormatException runtime.

"d"

Modèle de date courte.

Informations supplémentaires :Spécificateur de format de date courte ("d").

6/15/2009 1:45:30 PM -> 6/15/2009 (en-US)

6/15/2009 1:45:30 PM -> 15/06/2009 (fr-FR)

6/15/2009 1:45:30 PM -> 2009/06/15 (ja-JP)

"D"

Modèle de date longue.

Informations supplémentaires :Spécificateur de format de date longue ("D").

6/15/2009 1:45:30 PM -> Monday, June 15, 2009 (en-US)

6/15/2009 1:45:30 PM -> 15 июня 2009 г. (ru-RU)

6/15/2009 1:45:30 PM -> 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").

6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45 PM (en-US)

6/15/2009 1:45:30 PM -> den 15 juni 2009 13:45 (sv-SE)

6/15/2009 1:45:30 PM -> Δευτέρα, 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").

6/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45:30 PM (en-US)

6/15/2009 1:45:30 PM -> den 15 juni 2009 13:45:30 (sv-SE)

6/15/2009 1:45:30 PM -> Δευτέρα, 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").

6/15/2009 1:45:30 PM -> 6/15/2009 1:45 PM (en-US)

6/15/2009 1:45:30 PM -> 15/06/2009 13:45 (es-ES)

6/15/2009 1:45:30 PM -> 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").

6/15/2009 1:45:30 PM -> 6/15/2009 1:45:30 PM (en-US)

6/15/2009 1:45:30 PM -> 15/06/2009 13:45:30 (es-ES)

6/15/2009 1:45:30 PM -> 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").

6/15/2009 1:45:30 PM -> June 15 (en-US)

6/15/2009 1:45:30 PM -> 15. juni (da-DK)

6/15/2009 1:45:30 PM -> 15 Juni (id-ID)

"O", "o"

Modèle de date/heure aller-retour.

Informations supplémentaires : Spécificateur de format aller-retour ("O", "o").

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30.0900000

"R", "r"

Modèle RFC1123.

Informations supplémentaires : Spécificateur de format RFC1123 ("R", "r").

6/15/2009 1:45:30 PM -> Mon, 15 Jun 2009 20:45:30 GMT

"s"

Modèle de date/heure pouvant être trié.

Informations supplémentaires : Spécificateur de format pouvant être trié ("s").

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30

"t"

Modèle d'heure courte.

Informations supplémentaires : Spécificateur de format d'heure courte ("t").

6/15/2009 1:45:30 PM -> 1:45 PM (en-US)

6/15/2009 1:45:30 PM -> 13:45 (hr-HR)

6/15/2009 1:45:30 PM -> 01:45 م (ar-EG)

"T"

Modèle d'heure longue.

Informations supplémentaires : Spécificateur de format d'heure longue ("T").

6/15/2009 1:45:30 PM -> 1:45:30 PM (en-US)

6/15/2009 1:45:30 PM -> 13:45:30 (hr-HR)

6/15/2009 1:45:30 PM -> 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").

6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z

"U"

Modèle de date/heure complet universel.

Informations supplémentaires : Spécificateur de format complet universel ("U").

6/15/2009 1:45:30 PM -> Monday, June 15, 2009 8:45:30 PM (en-US)

6/15/2009 1:45:30 PM -> den 15 juni 2009 20:45:30 (sv-SE)

6/15/2009 1:45:30 PM -> Δευτέρα, 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").

6/15/2009 1:45:30 PM -> June, 2009 (en-US)

6/15/2009 1:45:30 PM -> juni 2009 (da-DK)

6/15/2009 1:45:30 PM -> 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 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
Dim thisDate As Date = #03/15/2008#
Console.WriteLine(thisDate.ToString("d"))     ' Displays 3/15/2008

// 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

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
Dim thisDate As Date = #03/15/2008#
Dim culture As New CultureInfo("pt-BR")      
Console.WriteLine(thisDate.ToString("d", culture))   ' Displays 15/3/2008

// 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

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

// 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

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 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"	Aucun	yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzz
"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).

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

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

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

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.

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

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

Retour au tableau

Spécificateur de format de date longue ("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.LongDatePattern actuelle. Par exemple, la chaîne de format personnalisée pour la culture indifférente est "dddd, dd MMMM 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
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.

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

Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("D", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008                        
Console.WriteLine(date1.ToString("D", _
                  CultureInfo.CreateSpecificCulture("pt-BR")))
' Displays quinta-feira, 10 de abril de 2008                        
Console.WriteLine(date1.ToString("D", _
                  CultureInfo.CreateSpecificCulture("es-MX")))
' Displays jueves, 10 de abril de 2008

DateTime date1 = new DateTime(2008, 4, 10);
Console.WriteLine(date1.ToString("D", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008                        
Console.WriteLine(date1.ToString("D", 
                  CultureInfo.CreateSpecificCulture("pt-BR")));
// Displays quinta-feira, 10 de abril de 2008                        
Console.WriteLine(date1.ToString("D", 
                  CultureInfo.CreateSpecificCulture("es-MX")));
// Displays jueves, 10 de abril de 2008

Retour au tableau

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

Le spécificateur de format standard "f" représente une combinaison des modèles de date longue ("D") et d'heure courte ("t"), séparés par un espace.

Les informations de mise en forme d'un objet DateTimeFormatInfo spécifique affectent la chaîne de résultat. Le tableau suivant répertorie les propriétés de l'objet DateTimeFormatInfo qui peuvent contrôler la mise en forme de la chaîne retournée. Le spécificateur de format personnalisé retourné par les propriétés DateTimeFormatInfo.LongDatePattern et DateTimeFormatInfo.ShortTimePattern de certaines cultures ne peut pas utiliser toutes les propriétés.

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.

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

Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("f", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 6:30 AM                        
Console.WriteLine(date1.ToString("f", _
                  CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays jeudi 10 avril 2008 06:30

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("f", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 6:30 AM                        
Console.WriteLine(date1.ToString("f", 
                  CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays jeudi 10 avril 2008 06:30

Retour au tableau

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

Le spécificateur de format standard "F" représente une chaîne de format de date et d'heure personnalisée définie par la propriété DateTimeFormatInfo.FullDateTimePattern actuelle. Par exemple, la chaîne de format personnalisée pour la culture indifférente est "dddd, dd MMMM yyyy HH:mm:ss".

Le tableau suivant répertorie les propriétés de l'objet DateTimeFormatInfo qui peuvent contrôler la mise en forme de la chaîne retournée. Le spécificateur de format personnalisé qui est retourné par la propriété FullDateTimePattern de certaines cultures ne peut pas utiliser toutes les propriétés.

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.

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

Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("F", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("F", _
                  CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays jeudi 10 avril 2008 06:30:00

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("F", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("F", 
                  CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays jeudi 10 avril 2008 06:30:00

Retour au tableau

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

Le spécificateur de format standard "g" représente une combinaison des modèles de date courte ("d") et d'heure courte ("t"), séparés par un espace.

Les informations de mise en forme d'un objet DateTimeFormatInfo spécifique affectent la chaîne de résultat. Le tableau suivant répertorie les propriétés de l'objet DateTimeFormatInfo qui peuvent contrôler la mise en forme de la chaîne retournée. Le spécificateur de format personnalisé qui est retourné par les propriétés DateTimeFormatInfo.ShortDatePattern et DateTimeFormatInfo.ShortTimePattern de certaines cultures ne peut pas utiliser toutes les propriétés.

Propriété	Description
ShortDatePattern	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.
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.

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

Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("g", _
                  DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008 06:30                      
Console.WriteLine(date1.ToString("g", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 4/10/2008 6:30 AM                       
Console.WriteLine(date1.ToString("g", _
                  CultureInfo.CreateSpecificCulture("fr-BE")))
' Displays 10/04/2008 6:30

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("g", 
                  DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008 06:30                      
Console.WriteLine(date1.ToString("g", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 4/10/2008 6:30 AM                       
Console.WriteLine(date1.ToString("g", 
                  CultureInfo.CreateSpecificCulture("fr-BE")));
// Displays 10/04/2008 6:30

Retour au tableau

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

Le spécificateur de format standard "G" représente une combinaison des modèles de date courte ("d") et d'heure longue ("T"), séparés par un espace.

Les informations de mise en forme d'un objet DateTimeFormatInfo spécifique affectent la chaîne de résultat. Le tableau suivant répertorie les propriétés de l'objet DateTimeFormatInfo qui peuvent contrôler la mise en forme de la chaîne retournée. Le spécificateur de format personnalisé qui est retourné par les propriétés DateTimeFormatInfo.ShortDatePattern et DateTimeFormatInfo.LongTimePattern de certaines cultures ne peut pas utiliser toutes les propriétés.

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.

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

Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("G", _
                  DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008 06:30:00
Console.WriteLine(date1.ToString("G", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 4/10/2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("G", _
                  CultureInfo.CreateSpecificCulture("nl-BE")))
' Displays 10/04/2008 6:30:00

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("G", 
                  DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008 06:30:00
Console.WriteLine(date1.ToString("G", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 4/10/2008 6:30:00 AM                        
Console.WriteLine(date1.ToString("G", 
                  CultureInfo.CreateSpecificCulture("nl-BE")));
// Displays 10/04/2008 6:30:00

Retour au tableau

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

Le spécificateur de format standard "M" ou "m" représente une chaîne de format de date et d'heure personnalisée définie par la propriété DateTimeFormatInfo.MonthDayPattern actuelle. Par exemple, la chaîne de format personnalisée pour la culture indifférente est "MMMM dd".

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
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.

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

Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("m", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays April 10                        
Console.WriteLine(date1.ToString("m", _
                  CultureInfo.CreateSpecificCulture("ms-MY")))
' Displays 10 April

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("m", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays April 10                        
Console.WriteLine(date1.ToString("m", 
                  CultureInfo.CreateSpecificCulture("ms-MY")));
// Displays 10 April

Retour au tableau

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

Le spécificateur de format standard "O" ou "o" représente une chaîne de format de date et d'heure personnalisée à l'aide d'un modèle qui conserve les informations de fuseau horaire. Pour les valeurs DateTime, ce spécificateur de format est conçu pour conserver des valeurs de date et d'heure avec la propriété DateTime.Kind dans le texte. La chaîne mise en forme peut être de nouveau analysée à l'aide de la méthode DateTime.Parse(String, IFormatProvider, DateTimeStyles) ou DateTime.ParseExact si le paramètre styles a la valeur DateTimeStyles.RoundtripKind.

Le spécificateur de format standard "O" ou "o" correspond à la chaîne de format personnalisée "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" pour les valeurs DateTime et à la chaîne de format personnalisée "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzz" pour les valeurs DateTimeOffset. Dans cette chaîne, les paires de guillemets simples qui délimitent des caractères individuels, comme les traits d'union, les deux-points et la lettre "T", indiquent que le caractère individuel est un littéral qui ne peut pas être modifié. Les apostrophes n'apparaissent pas dans la chaîne de sortie.

Pour ce spécificateur, le modèle reflète un standard défini (ISO 8601). Par conséquent, il s'agit toujours du même, quels que soient la culture utilisée ou le fournisseur de format spécifié. Les chaînes passées à la méthode Parse ou ParseExact doivent se conformer exactement à ce modèle de format personnalisé, ou une FormatException est levée.

Lorsque ce spécificateur de format standard est utilisé, l'opération de mise en forme ou d'analyse utilise toujours la culture indifférente.

L'exemple suivant utilise le spécificateur de format "o" pour afficher une valeur DateTime et DateTimeOffset sur un système situé dans le fuseau horaire Pacifique (États-Unis).

Dim date1 As Date = #4/10/2008 6:30AM#
Dim dateOffset As New DateTimeOffset(date1, TimeZoneInfo.Local.GetUtcOFfset(date1))
Console.WriteLine(date1.ToString("o"))
' Displays 2008-04-10T06:30:00.0000000                        
Console.WriteLine(dateOffset.ToString("o"))
' Displays 2008-04-10T06:30:00.0000000-07:00

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
DateTimeOffset dateOffset = new DateTimeOffset(date1, 
                            TimeZoneInfo.Local.GetUtcOffset(date1));
Console.WriteLine(date1.ToString("o"));
// Displays 2008-04-10T06:30:00.0000000                        
Console.WriteLine(dateOffset.ToString("o"));
// Displays 2008-04-10T06:30:00.0000000-07:00

L'exemple suivant utilise le spécificateur de format "o" pour créer une chaîne mise en forme, puis restaure la valeur de date et d'heure d'origine en appelant une méthode Parse de date et d'heure.

' Round-trip DateTime values.
Dim originalDate, newDate As Date
Dim dateString As String
' Round-trip a local time.
originalDate = Date.SpecifyKind(#4/10/2008 6:30AM#, DateTimeKind.Local)
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
                  newDate, newDate.Kind)
' Round-trip a UTC time.
originalDate = Date.SpecifyKind(#4/12/2008 9:30AM#, DateTimeKind.Utc)                  
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
                  newDate, newDate.Kind)
' Round-trip time in an unspecified time zone.
originalDate = Date.SpecifyKind(#4/13/2008 12:30PM#, DateTimeKind.Unspecified)                  
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
                  newDate, newDate.Kind)

' Round-trip a DateTimeOffset value.
Dim originalDTO As New DateTimeOffset(#4/12/2008 9:30AM#, New TimeSpan(-8, 0, 0))
dateString = originalDTO.ToString("o")
Dim newDTO As DateTimeOffset = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} to {1}.", originalDTO, newDTO)
' The example displays the following output:
'    Round-tripped 4/10/2008 6:30:00 AM Local to 4/10/2008 6:30:00 AM Local.
'    Round-tripped 4/12/2008 9:30:00 AM Utc to 4/12/2008 9:30:00 AM Utc.
'    Round-tripped 4/13/2008 12:30:00 PM Unspecified to 4/13/2008 12:30:00 PM Unspecified.
'    Round-tripped 4/12/2008 9:30:00 AM -08:00 to 4/12/2008 9:30:00 AM -08:00.

// Round-trip DateTime values.
DateTime originalDate, newDate;
string dateString;
// Round-trip a local time.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 10, 6, 30, 0), DateTimeKind.Local);
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  newDate, newDate.Kind);
// Round-trip a UTC time.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 12, 9, 30, 0), DateTimeKind.Utc);                  
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  newDate, newDate.Kind);
// Round-trip time in an unspecified time zone.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 13, 12, 30, 0), DateTimeKind.Unspecified);                  
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  newDate, newDate.Kind);

// Round-trip a DateTimeOffset value.
DateTimeOffset originalDTO = new DateTimeOffset(2008, 4, 12, 9, 30, 0, new TimeSpan(-8, 0, 0));
dateString = originalDTO.ToString("o");
DateTimeOffset newDTO = DateTimeOffset.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Round-tripped {0} to {1}.", originalDTO, newDTO);
// The example displays the following output:
//    Round-tripped 4/10/2008 6:30:00 AM Local to 4/10/2008 6:30:00 AM Local.
//    Round-tripped 4/12/2008 9:30:00 AM Utc to 4/12/2008 9:30:00 AM Utc.
//    Round-tripped 4/13/2008 12:30:00 PM Unspecified to 4/13/2008 12:30:00 PM Unspecified.
//    Round-tripped 4/12/2008 9:30:00 AM -08:00 to 4/12/2008 9:30:00 AM -08:00.

Retour au tableau

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

Le spécificateur de format standard "R" ou "r" représente une chaîne de format de date et d'heure personnalisée définie par la propriété DateTimeFormatInfo.RFC1123Pattern actuelle. Le modèle reflète une norme définie, et la propriété est en lecture seule. Par conséquent, il s'agit toujours du même, quels que soient la culture utilisée ou le fournisseur de format spécifié. La chaîne de format personnalisée est "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'". Lorsque ce spécificateur de format standard est utilisé, l'opération de mise en forme ou d'analyse utilise toujours la culture indifférente.

La chaîne de résultat est affectée par les propriétés suivantes de l'objet DateTimeFormatInfo retourné par la propriété DateTimeFormatInfo.InvariantInfo qui représente la culture dite indifférente.

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.

Bien que la norme RFC 1123 exprime une heure au format de temps universel coordonné (UTC, Coordinated Universal Time), l'opération de mise en forme ne modifie pas la valeur de l'objet DateTime ou DateTimeOffset qui est mis en forme. Par conséquent, l'application doit convertir la valeur de date et d'heure en temps UTC avant d'exécuter l'opération de mise en forme. Pour effectuer cette conversion, les valeurs DateTime peuvent appeler la méthode DateTime.ToUniversalTime, et les valeurs DateTimeOffset peuvent appeler la méthode ToUniversalTime.

L'exemple suivant utilise le spécificateur de format "r" pour afficher une valeur DateTime et DateTimeOffset sur un système situé dans le fuseau horaire Pacifique (États-Unis).

Dim date1 As Date = #4/10/2008 6:30AM#
Dim dateOffset As New DateTimeOffset(date1, TimeZoneInfo.Local.GetUtcOFfset(date1))
Console.WriteLine(date1.ToUniversalTime.ToString("r"))
' Displays Thu, 10 Apr 2008 13:30:00 GMT                       
Console.WriteLine(dateOffset.ToUniversalTime.ToString("r"))
' Displays Thu, 10 Apr 2008 13:30:00 GMT

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
DateTimeOffset dateOffset = new DateTimeOffset(date1, 
                            TimeZoneInfo.Local.GetUtcOffset(date1));
Console.WriteLine(date1.ToUniversalTime().ToString("r"));
// Displays Thu, 10 Apr 2008 13:30:00 GMT                       
Console.WriteLine(dateOffset.ToUniversalTime().ToString("r"));
// Displays Thu, 10 Apr 2008 13:30:00 GMT

Retour au tableau

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

Le spécificateur de format standard "s" représente une chaîne de format de date et d'heure personnalisée définie par la propriété DateTimeFormatInfo.SortableDateTimePattern actuelle. Le modèle reflète une norme définie (ISO 8601), et la propriété est en lecture seule. Par conséquent, il s'agit toujours du même, quels que soient la culture utilisée ou le fournisseur de format spécifié. La chaîne de format personnalisée est "yyyy'-'MM'-'dd'T'HH':'mm':'ss".

Lorsque ce spécificateur de format standard est utilisé, l'opération de mise en forme ou d'analyse utilise toujours la culture indifférente.

L'exemple suivant utilise le spécificateur de format "s" pour afficher une valeur DateTime et DateTimeOffset sur un système situé dans le fuseau horaire Pacifique (États-Unis).

Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("s"))
' Displays 2008-04-10T06:30:00

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("s"));
// Displays 2008-04-10T06:30:00

Retour au tableau

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

Le spécificateur de format standard "t" représente une chaîne de format de date et d'heure personnalisée définie par la propriété DateTimeFormatInfo.ShortTimePattern actuelle. Par exemple, la chaîne de format personnalisée pour la culture indifférente est "HH:mm".

Les informations de mise en forme d'un objet DateTimeFormatInfo spécifique affectent la chaîne de résultat. Le tableau suivant répertorie les propriétés de l'objet DateTimeFormatInfo qui peuvent contrôler la mise en forme de la chaîne retournée. Le spécificateur de format personnalisé qui est retourné par la propriété DateTimeFormatInfo.ShortTimePattern de certaines cultures ne peut pas utiliser toutes les propriétés.

Propriété	Description
ShortTimePattern	Définit le format du composant « heure » de 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.

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

Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("t", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 6:30 AM                        
Console.WriteLine(date1.ToString("t", _
                  CultureInfo.CreateSpecificCulture("es-ES")))
' Displays 6:30

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("t", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 6:30 AM                        
Console.WriteLine(date1.ToString("t", 
                  CultureInfo.CreateSpecificCulture("es-ES")));
// Displays 6:30

Retour au tableau

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

Le spécificateur de format standard "T" représente une chaîne de format de date et d'heure personnalisée définie par la propriété DateTimeFormatInfo.LongTimePattern d'une culture spécifique. Par exemple, la chaîne de format personnalisée pour la culture indifférente est "HH:mm:ss".

Le tableau suivant répertorie les propriétés de l'objet DateTimeFormatInfo qui peuvent contrôler la mise en forme de la chaîne retournée. Le spécificateur de format personnalisé qui est retourné par la propriété DateTimeFormatInfo.LongTimePattern de certaines cultures ne peut pas utiliser toutes les propriétés.

Propriété	Description
LongTimePattern	Définit le format du composant « heure » de 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.

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

Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("T", _
                  CultureInfo.CreateSpecificCulture("en-us")))
' Displays 6:30:00 AM                       
Console.WriteLine(date1.ToString("T", _
                  CultureInfo.CreateSpecificCulture("es-ES")))
' Displays 6:30:00

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("T", 
                  CultureInfo.CreateSpecificCulture("en-us")));
// Displays 6:30:00 AM                       
Console.WriteLine(date1.ToString("T", 
                  CultureInfo.CreateSpecificCulture("es-ES")));
// Displays 6:30:00

Retour au tableau

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

Le spécificateur de format standard "u" représente une chaîne de format de date et d'heure personnalisée définie par la propriété DateTimeFormatInfo.UniversalSortableDateTimePattern actuelle. Le modèle reflète une norme définie, et la propriété est en lecture seule. Par conséquent, il s'agit toujours du même, quels que soient la culture utilisée ou le fournisseur de format spécifié. La chaîne de format personnalisée est "yyyy'-'MM'-'dd HH':'mm':'ss'Z'". Lorsque ce spécificateur de format standard est utilisé, l'opération de mise en forme ou d'analyse utilise toujours la culture indifférente.

Bien que la chaîne de résultat doive exprimer une heure au format de temps universel coordonné (UTC, Coordinated Universal Time), aucune conversion de la valeur DateTime ou DateTimeOffset d'origine n'est effectuée pendant l'opération de mise en forme. Par conséquent, l'application doit convertir la valeur de date et d'heure en temps UTC avant de la mettre en forme. Pour effectuer cette conversion, les valeurs DateTime peuvent appeler la méthode DateTime.ToUniversalTime, et les valeurs DateTimeOffset peuvent appeler la méthode ToUniversalTime.

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

Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToUniversalTime.ToString("u"))
' Displays 2008-04-10 13:30:00Z

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToUniversalTime().ToString("u"));
// Displays 2008-04-10 13:30:00Z

Retour au tableau

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

Le spécificateur de format standard "U" représente une chaîne de format de date et d'heure personnalisée définie par la propriété DateTimeFormatInfo.FullDateTimePattern d'une culture spécifiée. Le modèle est identique au modèle "F". Toutefois, la valeur DateTime est automatiquement convertie en temps UTC avant d'être mise en forme.

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.

Le spécificateur de format "U" n'est pas pris en charge par le type DateTimeOffset et lève un FormatException s'il est utilisé pour mettre en forme une valeur DateTimeOffset.

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

Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("U", CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 1:30:00 PM                       
Console.WriteLine(date1.ToString("U", CultureInfo.CreateSpecificCulture("sv-FI")))
' Displays den 10 april 2008 13:30:00

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("U", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 1:30:00 PM                       
Console.WriteLine(date1.ToString("U", 
                  CultureInfo.CreateSpecificCulture("sv-FI")));
// Displays den 10 april 2008 13:30:00

Retour au tableau

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

Le spécificateur de format standard "Y" ou "y" représente une chaîne de format de date et d'heure personnalisée définie par la propriété DateTimeFormatInfo.YearMonthPattern d'une culture spécifiée. Par exemple, la chaîne de format personnalisée pour la culture indifférente est "yyyy MMMM".

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
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.

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

Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("Y", CultureInfo.CreateSpecificCulture("en-US")))
' Displays April, 2008                       
Console.WriteLine(date1.ToString("y", CultureInfo.CreateSpecificCulture("af-ZA")))
' Displays April 2008

DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("Y", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays April, 2008                       
Console.WriteLine(date1.ToString("y", 
                  CultureInfo.CreateSpecificCulture("af-ZA")));
// Displays April 2008

Retour au tableau

Remarques

Paramètres du panneau de configuration

Les paramètres de l'élément Options régionales et linguistiques du Panneau de configuration influencent la chaîne résultante produite par une opération de mise en forme. Ces paramètres sont utilisés pour initialiser l'objet DateTimeFormatInfo associé à la culture du thread en cours qui fournit des valeurs utilisées pour indiquer la mise en forme. Les ordinateurs qui utilisent des paramètres différents génèrent des chaînes de résultat différentes.

De plus, si vous utilisez le constructeur CultureInfo.CultureInfo(String) pour instancier un nouvel objet CultureInfo qui représente la même culture que la culture système en cours, toutes les personnalisations établies par l'élément Options régionales et linguistiques du Panneau de configuration seront appliquées au nouvel objet CultureInfo. Vous pouvez utiliser le constructeur CultureInfo.CultureInfo(String, Boolean) pour créer un objet CultureInfo qui ne reflète pas les personnalisations d'un système.

Propriétés DateTimeFormatInfo

La mise en forme dépend des propriétés de l'objet DateTimeFormatInfo actif, qui est fourni implicitement par la culture actuelle du thread ou explicitement par le paramètre IFormatProvider de la méthode qui appelle la mise en forme. Pour le paramètre IFormatProvider, votre application doit spécifier un objet CultureInfo, qui représente une culture, ou un objet DateTimeFormatInfo, qui représente les conventions de présentation de la date et de l'heure d'une culture particulière. La plupart des spécificateurs de format de date et d'heure standard sont des alias des modèles de mise en forme définis par les propriétés de l'objet DateTimeFormatInfo en cours. Votre application peut modifier le résultat produit par certains spécificateurs de format de date et d'heure standard en modifiant les modèles de format de date et d'heure correspondants de la propriété DateTimeFormatInfo correspondante.

Voir aussi

Concepts

Mise en forme des types

Chaînes de format de date et d'heure personnalisées

Historique des modifications

Date	Historique	Motif
Juillet 2010	Ajout d'informations sur les chaînes de format standard dans les opérations d'analyse.	Commentaires client.
Mars 2011	Ajout d'un lien vers l'utilitaire de formatage.	Améliorations apportées aux informations.

Juillet 2010

Ajout d'informations sur les chaînes de format standard dans les opérations d'analyse.

Commentaires client.

Mars 2011

Ajout d'un lien vers l'utilitaire de formatage.

Améliorations apportées aux informations.

Partager via

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

Fonctionnement des chaînes de format standard

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

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

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 de mois ("M", "m")

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 d'heure courte ("t")

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

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

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

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

Remarques

Paramètres du panneau de configuration

Propriétés DateTimeFormatInfo

Voir aussi

Concepts

Historique des modifications

Ressources supplémentaires