Chaînes de format de date et d'heure standardStandard Date and Time Format Strings

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.A standard date and time format string uses a single format specifier to define the text representation of a date and time value. Toute chaîne de format de date et d’heure contenant plusieurs caractères, y compris un espace, 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.Any date and time format string that contains more than one character, including white space, is interpreted as a custom date and time format string; for more information, see Custom Date and Time Format Strings. Une chaîne de format standard ou personnalisée peut être utilisée de deux façons :A standard or custom format string can be used in two ways:

  • Pour définir la chaîne qui résulte d'une opération de mise en forme.To define the string that results from a formatting operation.

  • 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.To define the text representation of a date and time value that can be converted to a DateTime or DateTimeOffset value by a parsing operation.

Conseil

Vous pouvez télécharger l’utilitaire de mise en forme, application .NET Core 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.You can download the Formatting Utility, a .NET Core Windows Forms application that lets you apply format strings to either numeric or date and time values and displays the result string. Le code source est disponible pour C# et Visual Basic.Source code is available for C# and Visual Basic.

Les chaînes de format de date et d'heure standard peuvent être utilisées avec les valeurs DateTime et DateTimeOffset.Standard date and time format strings can be used with both DateTime and DateTimeOffset values.

Notes

Certains exemples C# de cet article s’exécutent dans l’exécuteur et le terrain de jeu du code inline Try.NET.Some of the C# examples in this article run in the Try.NET inline code runner and playground. Sélectionnez le bouton Exécuter pour exécuter un exemple dans une fenêtre interactive.Select the Run button to run an example in an interactive window. Une fois que vous avez exécuté le code, vous pouvez le modifier et exécuter le code modifié en resélectionnant Exécuter.Once you execute the code, you can modify it and run the modified code by selecting Run again. 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#.The modified code either runs in the interactive window or, if compilation fails, the interactive window displays all C# compiler error messages.

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.The local time zone of the Try.NET inline code runner and playground is Coordinated Universal Time, or UTC. Cela peut affecter le comportement et la sortie d’exemples qui illustrent les types DateTime, DateTimeOffset et TimeZoneInfo ainsi que leurs membres.This may affect the behavior and the output of examples that illustrate the DateTime, DateTimeOffset, and TimeZoneInfo types and their members.

Le tableau suivant décrit les spécificateurs de format de date et d’heure standard.The following table describes the standard date and time format specifiers. 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.Unless otherwise noted, a particular standard date and time format specifier produces an identical string representation regardless of whether it is used with a DateTime or a DateTimeOffset value. Pour plus d’informations sur l’utilisation de chaînes de format de date et d’heure standard, consultez la section Remarques.See the Notes section for additional information about using standard date and time format strings.

Spécificateur de formatFormat specifier DescriptionDescription ExemplesExamples
"d""d" Modèle de date courte.Short date pattern.

Informations supplémentaires :Spécificateur de format de date courte ("d").More information:The Short Date ("d") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 (en-US)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 -> 15/06/2009 (fr-FR)

2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D""D" Modèle de date longue.Long date pattern.

Informations supplémentaires :Spécificateur de format de date longue ("D").More information:The Long Date ("D") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)

2009-06-15T13:45:30 -> 15 июня 2009 г.2009-06-15T13:45:30 -> 15 июня 2009 г. (ru-RU)(ru-RU)

2009-06-15T13:45:30 -> Montag, 15.2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)Juni 2009 (de-DE)
"f""f" Modèle de date/heure complet (heure courte).Full date/time pattern (short time).

Informations complémentaires : Spécificateur de format de date complet et d’heure courte ("f").More information: The Full Date Short Time ("f") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US)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 -> den 15 juni 2009 13:45 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F""F" Modèle de date/heure complet (heure longue).Full date/time pattern (long time).

Informations complémentaires : Spécificateur de format de date complet et d’heure longue ("F").More information: The Full Date Long Time ("F") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US)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 -> den 15 juni 2009 13:45:30 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g""g" Modèle de date/heure général (heure courte).General date/time pattern (short time).

Informations complémentaires : Spécificateur de format de date général et d’heure courte ("g").More information: The General Date Short Time ("g") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US)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 -> 15/06/2009 13:45 (es-ES)

2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G""G" Modèle de date/heure général (heure longue).General date/time pattern (long time).

Informations complémentaires : Spécificateur de format de date général et d’heure longue ("G").More information: The General Date Long Time ("G") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US)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 -> 15/06/2009 13:45:30 (es-ES)

2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m""M", "m" Modèle de mois/jour.Month/day pattern.

Informations complémentaires : Spécificateur de format de mois ("M", "m").More information: The Month ("M", "m") Format Specifier.
2009-06-15T13:45:30 -> June 15 (en-US)2009-06-15T13:45:30 -> June 15 (en-US)

2009-06-15T13:45:30 -> 15.2009-06-15T13:45:30 -> 15. juni (da-DK)juni (da-DK)

2009-06-15T13:45:30 -> 15 Juni (id-ID)2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o""O", "o" Modèle de date/heure aller-retour.Round-trip date/time pattern.

Informations complémentaires : Spécificateur de format aller-retour ("O", "o").More information: The Round-trip ("O", "o") Format Specifier.
Valeurs DateTime :DateTime values:

2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:002009-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.0000000Z2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z

2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.00000002009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000

Valeurs DateTimeOffset :DateTimeOffset values:

2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:002009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
"R", "r""R", "r" Modèle RFC1123.RFC1123 pattern.

Informations complémentaires : Spécificateur de format RFC1123 ("R", "r").More information: The RFC1123 ("R", "r") Format Specifier.
2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT
"s""s" Modèle de date/heure pouvant être trié.Sortable date/time pattern.

Informations complémentaires : Spécificateur de format pouvant être trié ("s").More information: The Sortable ("s") Format Specifier.
2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:302009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30

2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:302009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
"t""t" Modèle d’heure courte.Short time pattern.

Informations complémentaires : Spécificateur de format d’heure courte ("t").More information: The Short Time ("t") Format Specifier.
2009-06-15T13:45:30 -> 1:45 PM (en-US)2009-06-15T13:45:30 -> 1:45 PM (en-US)

2009-06-15T13:45:30 -> 13:45 (hr-HR)2009-06-15T13:45:30 -> 13:45 (hr-HR)

2009-06-15T13:45:30 -> 01:45 م (ar-EG)2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T""T" Modèle d’heure longue.Long time pattern.

Informations complémentaires : Spécificateur de format d’heure longue ("T").More information: The Long Time ("T") Format Specifier.
2009-06-15T13:45:30 -> 1:45:30 PM (en-US)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 -> 13:45:30 (hr-HR)

2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u""u" Modèle de date/heure universel pouvant être trié.Universal sortable date/time pattern.

Informations complémentaires : Spécificateur de format universel pouvant être trié ("u").More information: The Universal Sortable ("u") Format Specifier.
Avec une valeur DateTime : 2009-06-15T13:45:30 -> 2009-06-15 13:45:30ZWith a DateTime value: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z

Avec une valeur DateTimeOffset : 2009-06-15T13:45:30 -> 2009-06-15 20:45:30ZWith a DateTimeOffset value: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U""U" Modèle de date/heure complet universel.Universal full date/time pattern.

Informations complémentaires : Spécificateur de format complet universel ("U").More information: The Universal Full ("U") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 8:45:30 PM (en-US)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 -> den 15 juni 2009 20:45:30 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
"Y", "y""Y", "y" Modèle d’année/mois.Year month pattern.

Informations complémentaires : Spécificateur de format Année Mois ("Y").More information: The Year Month ("Y") Format Specifier.
2009-06-15T13:45:30 -> June, 2009 (en-US)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 (da-DK)

2009-06-15T13:45:30 -> Juni 2009 (id-ID)2009-06-15T13:45:30 -> Juni 2009 (id-ID)
N'importe quel caractèreAny other single character Spécificateur inconnu.Unknown specifier. Lève un FormatException runtime.Throws a run-time FormatException.

Fonctionnement des chaînes de format standardHow Standard Format Strings Work

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.In a formatting operation, a standard format string is simply an alias for a custom format string. 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.The advantage of using an alias to refer to a custom format string is that, although the alias remains invariant, the custom format string itself can vary. 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.This is important because the string representations of date and time values typically vary by 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.For example, the "d" standard format string indicates that a date and time value is to be displayed using a short date pattern. Pour la culture dite indifférente, ce modèle est "MM/dd/yyyy".For the invariant culture, this pattern is "MM/dd/yyyy". Pour la culture fr-FR, il s'agit de "dd/MM/yyyy".For the fr-FR culture, it is "dd/MM/yyyy". Pour la culture ja-JP, il s'agit de "yyyy/MM/dd".For the ja-JP culture, it is "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 :If a standard format string in a formatting operation maps to a particular culture's custom format string, your application can define the specific culture whose custom format strings are used in one of these ways:

  • Vous pouvez utiliser la culture par défaut (ou actuelle).You can use the default (or current) culture. L'exemple suivant affiche une date à l'aide du format de date courte de la culture actuelle.The following example displays a date using the current culture's short date format. Dans ce cas, la culture actuelle est en-US.In this case, the current culture is 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.You can pass a CultureInfo object representing the culture whose formatting is to be used to a method that has an IFormatProvider parameter. L'exemple suivant affiche une date à l'aide du format de date courte de la culture pt-BR.The following example displays a date using the short date format of the pt-BR culture.

    // 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.You can pass a DateTimeFormatInfo object that provides formatting information to a method that has an IFormatProvider parameter. L'exemple suivant affiche une date à l'aide du format de date courte d'un objet DateTimeFormatInfo pour la culture hr-HR.The following example displays a date using the short date format from a DateTimeFormatInfo object for the hr-HR culture.

    // 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.For information about customizing the patterns or strings used in formatting date and time values, see the NumberFormatInfo class topic.

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.In some cases, the standard format string serves as a convenient abbreviation for a longer custom format string that is invariant. Quatre chaînes de format standard appartiennent à cette catégorie : "O" (ou "o"), "R" (ou "r"), "s" et "u".Four standard format strings fall into this category: "O" (or "o"), "R" (or "r"), "s", and "u". Ces chaînes correspondent aux chaînes de format personnalisées définies par la culture dite indifférente.These strings correspond to custom format strings defined by the invariant culture. 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.They produce string representations of date and time values that are intended to be identical across cultures. Le tableau suivant fournit des informations sur ces quatre chaînes de format de date et d'heure standard.The following table provides information on these four standard date and time format strings.

Chaîne de format standardStandard format string Défini par la propriété DateTimeFormatInfo.InvariantInfoDefined by DateTimeFormatInfo.InvariantInfo property Chaîne de format personnaliséeCustom format string
"O" ou "o""O" or "o" Aucun.None yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzyyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzz
"R" ou "r""R" or "r" RFC1123Pattern ddd, dd MMM yyyy HH':'mm':'ss 'GMT'ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s""s" SortableDateTimePattern yyyy'-'MM'-'dd'T'HH':'mm':'ssyyyy'-'MM'-'dd'T'HH':'mm':'ss
"u""u" UniversalSortableDateTimePattern yyyy'-'MM'-'dd HH':'mm':'ss'Z'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.Standard format strings can also be used in parsing operations with the DateTime.ParseExact or DateTimeOffset.ParseExact methods, which require an input string to exactly conform to a particular pattern for the parse operation to succeed. 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.Many standard format strings map to multiple custom format strings, so a date and time value can be represented in a variety of formats and the parse operation will still succeed. 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).You can determine the custom format string or strings that correspond to a standard format string by calling the DateTimeFormatInfo.GetAllDateTimePatterns(Char) method. 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).The following example displays the custom format strings that map to the "d" (short date pattern) standard format string.

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.The following sections describe the standard format specifiers for DateTime and DateTimeOffset values.

Spécificateur de format de date courte ("d")The Short Date ("d") Format Specifier

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.The "d" standard format specifier represents a custom date and time format string that is defined by a specific culture's DateTimeFormatInfo.ShortDatePattern property. 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".For example, the custom format string that is returned by the ShortDatePattern property of the invariant culture is "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.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

PropertyProperty DescriptionDescription
ShortDatePattern Définit le format global de la chaîne de résultat.Defines the overall format of the result string.
DateSeparator Définit la chaîne qui sépare les composants « année », « mois » et « jour » d'une date.Defines the string that separates the year, month, and day components of a date.

L'exemple suivant utilise le spécificateur de format "d" pour afficher une valeur de date et d'heure.The following example uses the "d" format specifier to display a date and time value.

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                       

Retour au tableauBack to table

Spécificateur de format de date longue ("D")The Long Date ("D") Format Specifier

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.The "D" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.LongDatePattern property. Par exemple, la chaîne de format personnalisée pour la culture dite indifférente est "dddd, dd MMMM yyyy".For example, the custom format string for the invariant culture is "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.The following table lists the properties of the DateTimeFormatInfo object that control the formatting of the returned string.

PropertyProperty DescriptionDescription
LongDatePattern Définit le format global de la chaîne de résultat.Defines the overall format of the result string.
DayNames Définit les noms de jours localisés qui peuvent apparaître dans la chaîne de résultat.Defines the localized day names that can appear in the result string.
MonthNames Définit les noms de mois localisés qui peuvent apparaître dans la chaîne de résultat.Defines the localized month names that can appear in the result string.

L'exemple suivant utilise le spécificateur de format "D" pour afficher une valeur de date et d'heure.The following example uses the "D" format specifier to display a date and time value.

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

Retour au tableauBack to table

Spécificateur de format de date complet et d'heure courte ("f")The Full Date Short Time ("f") Format Specifier

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.The "f" standard format specifier represents a combination of the long date ("D") and short time ("t") patterns, separated by a space.

Les informations de mise en forme d'un objet DateTimeFormatInfo spécifique affectent la chaîne de résultat.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. 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.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. 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.The custom format specifier returned by the DateTimeFormatInfo.LongDatePattern and DateTimeFormatInfo.ShortTimePattern properties of some cultures may not make use of all properties.

PropertyProperty DescriptionDescription
LongDatePattern Définit le format du composant « date » de la chaîne de résultat.Defines the format of the date component of the result string.
ShortTimePattern Définit le format du composant « heure » de la chaîne de résultat.Defines the format of the time component of the result string.
DayNames Définit les noms de jours localisés qui peuvent apparaître dans la chaîne de résultat.Defines the localized day names that can appear in the result string.
MonthNames Définit les noms de mois localisés qui peuvent apparaître dans la chaîne de résultat.Defines the localized month names that can appear in the result string.
TimeSeparator Définit la chaîne qui sépare les composants « heure », « minute » et « seconde » d'une heure.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Définit la chaîne qui indique les heures de minuit à avant midi sur une horloge au format 12 heures.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Définit la chaîne qui indique les heures de midi à avant minuit sur une horloge au format 12 heures.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

L'exemple suivant utilise le spécificateur de format "f" pour afficher une valeur de date et d'heure.The following example uses the "f" format specifier to display a date and time value.

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

Retour au tableauBack to table

Spécificateur de format de date complet et d'heure longue ("F")The Full Date Long Time ("F") Format Specifier

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.The "F" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.FullDateTimePattern property. Par exemple, la chaîne de format personnalisée pour la culture dite indifférente est "dddd, dd MMMM yyyy HH:mm:ss".For example, the custom format string for the invariant culture is "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.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. 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.The custom format specifier that is returned by the FullDateTimePattern property of some cultures may not make use of all properties.

PropertyProperty DescriptionDescription
FullDateTimePattern Définit le format global de la chaîne de résultat.Defines the overall format of the result string.
DayNames Définit les noms de jours localisés qui peuvent apparaître dans la chaîne de résultat.Defines the localized day names that can appear in the result string.
MonthNames Définit les noms de mois localisés qui peuvent apparaître dans la chaîne de résultat.Defines the localized month names that can appear in the result string.
TimeSeparator Définit la chaîne qui sépare les composants « heure », « minute » et « seconde » d'une heure.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Définit la chaîne qui indique les heures de minuit à avant midi sur une horloge au format 12 heures.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Définit la chaîne qui indique les heures de midi à avant minuit sur une horloge au format 12 heures.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

L'exemple suivant utilise le spécificateur de format "F" pour afficher une valeur de date et d'heure.The following example uses the "F" format specifier to display a date and time value.

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

Retour au tableauBack to table

Spécificateur de format de date général et d'heure courte ("g")The General Date Short Time ("g") Format Specifier

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.The "g" standard format specifier represents a combination of the short date ("d") and short time ("t") patterns, separated by a space.

Les informations de mise en forme d'un objet DateTimeFormatInfo spécifique affectent la chaîne de résultat.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. 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.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. 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.The custom format specifier that is returned by the DateTimeFormatInfo.ShortDatePattern and DateTimeFormatInfo.ShortTimePattern properties of some cultures may not make use of all properties.

PropertyProperty DescriptionDescription
ShortDatePattern Définit le format du composant « date » de la chaîne de résultat.Defines the format of the date component of the result string.
ShortTimePattern Définit le format du composant « heure » de la chaîne de résultat.Defines the format of the time component of the result string.
DateSeparator Définit la chaîne qui sépare les composants « année », « mois » et « jour » d'une date.Defines the string that separates the year, month, and day components of a date.
TimeSeparator Définit la chaîne qui sépare les composants « heure », « minute » et « seconde » d'une heure.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Définit la chaîne qui indique les heures de minuit à avant midi sur une horloge au format 12 heures.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Définit la chaîne qui indique les heures de midi à avant minuit sur une horloge au format 12 heures.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

L'exemple suivant utilise le spécificateur de format "g" pour afficher une valeur de date et d'heure.The following example uses the "g" format specifier to display a date and time value.

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

Retour au tableauBack to table

Spécificateur de format de date général et d'heure longue ("G")The General Date Long Time ("G") Format Specifier

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.The "G" standard format specifier represents a combination of the short date ("d") and long time ("T") patterns, separated by a space.

Les informations de mise en forme d'un objet DateTimeFormatInfo spécifique affectent la chaîne de résultat.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. 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.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. 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.The custom format specifier that is returned by the DateTimeFormatInfo.ShortDatePattern and DateTimeFormatInfo.LongTimePattern properties of some cultures may not make use of all properties.

PropertyProperty DescriptionDescription
ShortDatePattern Définit le format du composant « date » de la chaîne de résultat.Defines the format of the date component of the result string.
LongTimePattern Définit le format du composant « heure » de la chaîne de résultat.Defines the format of the time component of the result string.
DateSeparator Définit la chaîne qui sépare les composants « année », « mois » et « jour » d'une date.Defines the string that separates the year, month, and day components of a date.
TimeSeparator Définit la chaîne qui sépare les composants « heure », « minute » et « seconde » d'une heure.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Définit la chaîne qui indique les heures de minuit à avant midi sur une horloge au format 12 heures.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Définit la chaîne qui indique les heures de midi à avant minuit sur une horloge au format 12 heures.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

L'exemple suivant utilise le spécificateur de format "G" pour afficher une valeur de date et d'heure.The following example uses the "G" format specifier to display a date and time value.

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

Retour au tableauBack to table

Spécificateur de format de mois ("M", "m")The Month ("M", "m") Format Specifier

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.The "M" or "m" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.MonthDayPattern property. Par exemple, la chaîne de format personnalisée pour la culture dite indifférente est "MMMM dd".For example, the custom format string for the invariant culture is "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.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

PropertyProperty DescriptionDescription
MonthDayPattern Définit le format global de la chaîne de résultat.Defines the overall format of the result string.
MonthNames Définit les noms de mois localisés qui peuvent apparaître dans la chaîne de résultat.Defines the localized month names that can appear in the result string.

L'exemple suivant utilise le spécificateur de format "m" pour afficher une valeur de date et d'heure.The following example uses the "m" format specifier to display a date and time value.

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

Retour au tableauBack to table

Spécificateur de format aller-retour ("O", "o")The Round-trip ("O", "o") Format Specifier

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 et génère une chaîne de résultat conforme à la norme ISO 8601.The "O" or "o" standard format specifier represents a custom date and time format string using a pattern that preserves time zone information and emits a result string that complies with ISO 8601. 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.For DateTime values, this format specifier is designed to preserve date and time values along with the DateTime.Kind property in text. 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.The formatted string can be parsed back by using the DateTime.Parse(String, IFormatProvider, DateTimeStyles) or DateTime.ParseExact method if the styles parameter is set to 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.The "O" or "o" standard format specifier corresponds to the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" custom format string for DateTime values and to the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzz" custom format string for DateTimeOffset values. 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é.In this string, the pairs of single quotation marks that delimit individual characters, such as the hyphens, the colons, and the letter "T", indicate that the individual character is a literal that cannot be changed. Les apostrophes n'apparaissent pas dans la chaîne de sortie.The apostrophes do not appear in the output string.

Le spécificateur de format standard "O" ou "o" et la chaîne de format personnalisée "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" tirent parti des trois façons dont la norme ISO 8601 représente les informations de fuseau horaire pour conserver la propriété Kind des valeurs DateTime :The "O" or "o" standard format specifier (and the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" custom format string) takes advantage of the three ways that ISO 8601 represents time zone information to preserve the Kind property of DateTime values:

  • Le composant de fuseau horaire des valeurs de date et d'heure DateTimeKind.Local est un décalage par rapport à l'heure UTC (par exemple, +01:00, -07:00).The time zone component of DateTimeKind.Local date and time values is an offset from UTC (for example, +01:00, -07:00). Toutes les valeurs DateTimeOffset sont également représentées dans ce format.All DateTimeOffset values are also represented in this format.

  • Le composant de fuseau horaire des valeurs de date et d'heure DateTimeKind.Utc utilise "Z" (soit zéro décalage) pour représenter l'heure UTC.The time zone component of DateTimeKind.Utc date and time values uses "Z" (which stands for zero offset) to represent UTC.

  • Les valeurs de date et d'heure DateTimeKind.Unspecified ne possèdent aucune information de fuseau horaire.DateTimeKind.Unspecified date and time values have no time zone information.

Comme le spécificateur de format standard « O » ou « o » est conforme à une norme internationale, l’opération de mise en forme ou d’analyse qui recourt au spécificateur utilise toujours la culture dite indifférente et le calendrier grégorien.Because the "O" or "o" standard format specifier conforms to an international standard, the formatting or parsing operation that uses the specifier always uses the invariant culture and the Gregorian calendar.

Les chaînes transmises aux méthodes Parse, TryParse, ParseExact, et TryParseExact de DateTime et DateTimeOffset peuvent être analysées à l'aide du spécificateur de format "O" ou "o" si elles sont définies dans l'un de ces formats.Strings that are passed to the Parse, TryParse, ParseExact, and TryParseExact methods of DateTime and DateTimeOffset can be parsed by using the "O" or "o" format specifier if they are in one of these formats. Dans le cas des objets DateTime, la surcharge d'analyse que vous appelez doit également inclure un paramètre styles avec une valeur de DateTimeStyles.RoundtripKind.In the case of DateTime objects, the parsing overload that you call should also include a styles parameter with a value of DateTimeStyles.RoundtripKind. Notez que si vous appelez une méthode d'analyse avec la chaîne de format personnalisée qui correspond au spécificateur de format "O" ou "o", vous n'obtenez pas les mêmes résultats que "O" ou "o".Note that if you call a parsing method with the custom format string that corresponds to the "O" or "o" format specifier, you won't get the same results as "O" or "o". En effet, les méthodes d'analyse qui utilisent une chaîne de format personnalisée ne peuvent pas analyser la représentation sous forme de chaîne des valeurs de date et d'heure auxquelles fait défaut un composant de fuseau horaire ou qui recourent à "Z" pour indiquer l'heure UTC.This is because parsing methods that use a custom format string can't parse the string representation of date and time values that lack a time zone component or use "Z" to indicate UTC.

L’exemple suivant utilise le spécificateur de format « o » pour afficher une série de valeurs DateTime et une valeur DateTimeOffset sur un système situé dans le fuseau horaire Pacifique (États-Unis).The following example uses the "o" format specifier to display a series of DateTime values and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

using System;

public class Example
{
   public static void Main()
   {
       DateTime dat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                   DateTimeKind.Unspecified);
       Console.WriteLine("{0} ({1}) --> {0:O}", dat, dat.Kind); 
   
       DateTime uDat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                    DateTimeKind.Utc);
       Console.WriteLine("{0} ({1}) --> {0:O}", uDat, uDat.Kind);
       
       DateTime lDat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                    DateTimeKind.Local);
       Console.WriteLine("{0} ({1}) --> {0:O}\n", lDat, lDat.Kind);
       
       DateTimeOffset dto = new DateTimeOffset(lDat);
       Console.WriteLine("{0} --> {0:O}", dto);
   }
}
// The example displays the following output:
//    6/15/2009 1:45:30 PM (Unspecified) --> 2009-06-15T13:45:30.0000000
//    6/15/2009 1:45:30 PM (Utc) --> 2009-06-15T13:45:30.0000000Z
//    6/15/2009 1:45:30 PM (Local) --> 2009-06-15T13:45:30.0000000-07:00
//    
//    6/15/2009 1:45:30 PM -07:00 --> 2009-06-15T13:45:30.0000000-07:00
Module Example
   Public Sub Main()
       Dim dat As New Date(2009, 6, 15, 13, 45, 30, 
                           DateTimeKind.Unspecified)
       Console.WriteLine("{0} ({1}) --> {0:O}", dat, dat.Kind) 
   
       Dim uDat As New Date(2009, 6, 15, 13, 45, 30, DateTimeKind.Utc)
       Console.WriteLine("{0} ({1}) --> {0:O}", uDat, uDat.Kind)
       
       Dim lDat As New Date(2009, 6, 15, 13, 45, 30, DateTimeKind.Local)
       Console.WriteLine("{0} ({1}) --> {0:O}", lDat, lDat.Kind)
       Console.WriteLine()
       
       Dim dto As New DateTimeOffset(lDat)
       Console.WriteLine("{0} --> {0:O}", dto)
   End Sub
End Module
' The example displays the following output:
'    6/15/2009 1:45:30 PM (Unspecified) --> 2009-06-15T13:45:30.0000000
'    6/15/2009 1:45:30 PM (Utc) --> 2009-06-15T13:45:30.0000000Z
'    6/15/2009 1:45:30 PM (Local) --> 2009-06-15T13:45:30.0000000-07:00
'    
'    6/15/2009 1:45:30 PM -07:00 --> 2009-06-15T13:45:30.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.The following example uses the "o" format specifier to create a formatted string, and then restores the original date and time value by calling a date and time Parse method.

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

Retour au tableauBack to table

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

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.The "R" or "r" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.RFC1123Pattern property. Le modèle reflète une norme définie, et la propriété est en lecture seule.The pattern reflects a defined standard, and the property is read-only. Par conséquent, il s'agit toujours du même, quels que soient la culture utilisée ou le fournisseur de format spécifié.Therefore, it is always the same, regardless of the culture used or the format provider supplied. La chaîne de format personnalisée est "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'".The custom format string is "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 dite indifférente.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

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.The result string is affected by the following properties of the DateTimeFormatInfo object returned by the DateTimeFormatInfo.InvariantInfo property that represents the invariant culture.

PropertyProperty DescriptionDescription
RFC1123Pattern Définit le format de la chaîne de résultat.Defines the format of the result string.
AbbreviatedDayNames Définit les noms de jours abrégés qui peuvent s'afficher dans la chaîne de résultat.Defines the abbreviated day names that can appear in the result string.
AbbreviatedMonthNames Définit les noms de mois abrégés qui peuvent s'afficher dans la chaîne de résultat.Defines the abbreviated month names that can appear in the result string.

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 qui est mis en forme.Although the RFC 1123 standard expresses a time as Coordinated Universal Time (UTC), the formatting operation does not modify the value of the DateTime object that is being formatted. Par conséquent, vous devez convertir la valeur DateTime en temps UTC en appelant la méthode DateTime.ToUniversalTime avant d'exécuter l'opération de mise en forme.Therefore, you must convert the DateTime value to UTC by calling the DateTime.ToUniversalTime method before you perform the formatting operation. En revanche, les valeurs DateTimeOffset exécutent cette conversion automatiquement ; il n'est pas nécessaire d'appeler la méthode DateTimeOffset.ToUniversalTime avant l'opération de mise en forme.In contrast, DateTimeOffset values perform this conversion automatically; there is no need to call the DateTimeOffset.ToUniversalTime method before the formatting operation.

L’exemple suivant utilise le spécificateur de format « r » pour afficher une valeur DateTime et une valeur DateTimeOffset sur un système situé dans le fuseau horaire Pacifique (États-Unis).The following example uses the "r" format specifier to display a DateTime and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

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

Retour au tableauBack to table

Spécificateur de format pouvant être trié ("s")The Sortable ("s") Format Specifier

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.The "s" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.SortableDateTimePattern property. Le modèle reflète une norme définie (ISO 8601), et la propriété est en lecture seule.The pattern reflects a defined standard (ISO 8601), and the property is read-only. Par conséquent, il s'agit toujours du même, quels que soient la culture utilisée ou le fournisseur de format spécifié.Therefore, it is always the same, regardless of the culture used or the format provider supplied. La chaîne de format personnalisée est "yyyy'-'MM'-'dd'T'HH':'mm':'ss".The custom format string is "yyyy'-'MM'-'dd'T'HH':'mm':'ss".

L'objectif du spécificateur de format "s" est de produire des chaînes de résultats qui trient de façon cohérente par ordre croissant ou décroissant en fonction des valeurs de date et d'heure.The purpose of the "s" format specifier is to produce result strings that sort consistently in ascending or descending order based on date and time values. Par conséquent, bien que le spécificateur de format standard "s" représente une valeur de date et d'heure dans un format cohérent, l'opération de mise en forme ne modifie pas la valeur de l'objet de date et d'heure qui est mise en forme de façon à refléter sa propriété DateTime.Kind ou sa valeur DateTimeOffset.Offset.As a result, although the "s" standard format specifier represents a date and time value in a consistent format, the formatting operation does not modify the value of the date and time object that is being formatted to reflect its DateTime.Kind property or its DateTimeOffset.Offset value. Par exemple, les chaînes de résultat produites par la mise en forme des valeurs de date et d'heure 2014-11-15T18:32:17 + 00:00 et 2014-11-15T18:32:17 + 08:00 sont identiques.For example, the result strings produced by formatting the date and time values 2014-11-15T18:32:17+00:00 and 2014-11-15T18:32:17+08:00 are identical.

Lorsque ce spécificateur de format standard est utilisé, l'opération de mise en forme ou d'analyse utilise toujours la culture dite indifférente.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

L’exemple suivant utilise le spécificateur de format « s » pour afficher une valeur DateTime et une valeur DateTimeOffset sur un système situé dans le fuseau horaire Pacifique (États-Unis).The following example uses the "s" format specifier to display a DateTime and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

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

Retour au tableauBack to table

Spécificateur de format d'heure courte ("t")The Short Time ("t") Format Specifier

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.The "t" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.ShortTimePattern property. Par exemple, la chaîne de format personnalisée pour la culture dite indifférente est "HH:mm".For example, the custom format string for the invariant culture is "HH:mm".

Les informations de mise en forme d'un objet DateTimeFormatInfo spécifique affectent la chaîne de résultat.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. 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.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. 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.The custom format specifier that is returned by the DateTimeFormatInfo.ShortTimePattern property of some cultures may not make use of all properties.

PropertyProperty DescriptionDescription
ShortTimePattern Définit le format du composant « heure » de la chaîne de résultat.Defines the format of the time component of the result string.
TimeSeparator Définit la chaîne qui sépare les composants « heure », « minute » et « seconde » d'une heure.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Définit la chaîne qui indique les heures de minuit à avant midi sur une horloge au format 12 heures.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Définit la chaîne qui indique les heures de midi à avant minuit sur une horloge au format 12 heures.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

L'exemple suivant utilise le spécificateur de format "t" pour afficher une valeur de date et d'heure.The following example uses the "t" format specifier to display a date and time value.

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

Retour au tableauBack to table

Spécificateur de format d'heure longue ("T")The Long Time ("T") Format Specifier

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.The "T" standard format specifier represents a custom date and time format string that is defined by a specific culture's DateTimeFormatInfo.LongTimePattern property. Par exemple, la chaîne de format personnalisée pour la culture dite indifférente est "HH:mm:ss".For example, the custom format string for the invariant culture is "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.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. 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.The custom format specifier that is returned by the DateTimeFormatInfo.LongTimePattern property of some cultures may not make use of all properties.

PropertyProperty DescriptionDescription
LongTimePattern Définit le format du composant « heure » de la chaîne de résultat.Defines the format of the time component of the result string.
TimeSeparator Définit la chaîne qui sépare les composants « heure », « minute » et « seconde » d'une heure.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Définit la chaîne qui indique les heures de minuit à avant midi sur une horloge au format 12 heures.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Définit la chaîne qui indique les heures de midi à avant minuit sur une horloge au format 12 heures.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

L'exemple suivant utilise le spécificateur de format "T" pour afficher une valeur de date et d'heure.The following example uses the "T" format specifier to display a date and time value.

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

Retour au tableauBack to table

Spécificateur de format universel pouvant être trié ("u")The Universal Sortable ("u") Format Specifier

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.The "u" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.UniversalSortableDateTimePattern property. Le modèle reflète une norme définie, et la propriété est en lecture seule.The pattern reflects a defined standard, and the property is read-only. Par conséquent, il s'agit toujours du même, quels que soient la culture utilisée ou le fournisseur de format spécifié.Therefore, it is always the same, regardless of the culture used or the format provider supplied. La chaîne de format personnalisée est "yyyy'-'MM'-'dd HH':'mm':'ss'Z'".The custom format string is "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 dite indifférente.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

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 d'origine n'est effectuée pendant l'opération de mise en forme.Although the result string should express a time as Coordinated Universal Time (UTC), no conversion of the original DateTime value is performed during the formatting operation. Par conséquent, vous devez convertir une valeur DateTime en temps UTC en appelant la méthode DateTime.ToUniversalTime avant de la mettre en forme.Therefore, you must convert a DateTime value to UTC by calling the DateTime.ToUniversalTime method before formatting it. En revanche, les valeurs DateTimeOffset exécutent cette conversion automatiquement ; il n'est pas nécessaire d'appeler la méthode DateTimeOffset.ToUniversalTime avant l'opération de mise en forme.In contrast, DateTimeOffset values perform this conversion automatically; there is no need to call the DateTimeOffset.ToUniversalTime method before the formatting operation.

L'exemple suivant utilise le spécificateur de format « u » pour afficher une valeur de date et d'heure.The following example uses the "u" format specifier to display a date and time value.

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

Retour au tableauBack to table

Spécificateur de format complet universel ("U")The Universal Full ("U") Format Specifier

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.The "U" standard format specifier represents a custom date and time format string that is defined by a specified culture's DateTimeFormatInfo.FullDateTimePattern property. Le modèle est identique au modèle "F".The pattern is the same as the "F" pattern. Toutefois, la valeur DateTime est automatiquement convertie en temps UTC avant d'être mise en forme.However, the DateTime value is automatically converted to UTC before it is formatted.

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.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. 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.The custom format specifier that is returned by the FullDateTimePattern property of some cultures may not make use of all properties.

PropertyProperty DescriptionDescription
FullDateTimePattern Définit le format global de la chaîne de résultat.Defines the overall format of the result string.
DayNames Définit les noms de jours localisés qui peuvent apparaître dans la chaîne de résultat.Defines the localized day names that can appear in the result string.
MonthNames Définit les noms de mois localisés qui peuvent apparaître dans la chaîne de résultat.Defines the localized month names that can appear in the result string.
TimeSeparator Définit la chaîne qui sépare les composants « heure », « minute » et « seconde » d'une heure.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Définit la chaîne qui indique les heures de minuit à avant midi sur une horloge au format 12 heures.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Définit la chaîne qui indique les heures de midi à avant minuit sur une horloge au format 12 heures.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

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.The "U" format specifier is not supported by the DateTimeOffset type and throws a FormatException if it is used to format a DateTimeOffset value.

L'exemple suivant utilise le spécificateur de format "U" pour afficher une valeur de date et d'heure.The following example uses the "U" format specifier to display a date and time value.

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

Retour au tableauBack to table

Spécificateur de format Année Mois ("Y")The Year Month ("Y", "y") Format Specifier

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.The "Y" or "y" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.YearMonthPattern property of a specified culture. Par exemple, la chaîne de format personnalisée pour la culture dite indifférente est "yyyy MMMM".For example, the custom format string for the invariant culture is "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.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

PropertyProperty DescriptionDescription
YearMonthPattern Définit le format global de la chaîne de résultat.Defines the overall format of the result string.
MonthNames Définit les noms de mois localisés qui peuvent apparaître dans la chaîne de résultat.Defines the localized month names that can appear in the result string.

L'exemple suivant utilise le spécificateur de format "y" pour afficher une valeur de date et d'heure.The following example uses the "y" format specifier to display a date and time value.

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

Retour au tableauBack to table

NotesNotes

Paramètres du panneau de configurationControl Panel Settings

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.The settings in the Regional and Language Options item in Control Panel influence the result string produced by a formatting operation. 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.These settings are used to initialize the DateTimeFormatInfo object associated with the current thread culture, which provides values used to govern formatting. Les ordinateurs qui utilisent des paramètres différents génèrent des chaînes de résultat différentes.Computers that use different settings generate different result strings.

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 .In addition, if you use the CultureInfo.CultureInfo(String) constructor to instantiate a new CultureInfo object that represents the same culture as the current system culture, any customizations established by the Regional and Language Options item in Control Panel will be applied to the new CultureInfo object. 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.You can use the CultureInfo.CultureInfo(String, Boolean) constructor to create a CultureInfo object that does not reflect a system's customizations.

Propriétés DateTimeFormatInfoDateTimeFormatInfo Properties

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.Formatting is influenced by properties of the current DateTimeFormatInfo object, which is provided implicitly by the current thread culture or explicitly by the IFormatProvider parameter of the method that invokes formatting. 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.For the IFormatProvider parameter, your application should specify a CultureInfo object, which represents a culture, or a DateTimeFormatInfo object, which represents a particular culture's date and time formatting conventions. 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.Many of the standard date and time format specifiers are aliases for formatting patterns defined by properties of the current DateTimeFormatInfo object. 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.Your application can change the result produced by some standard date and time format specifiers by changing the corresponding date and time format patterns of the corresponding DateTimeFormatInfo property.

Voir aussiSee also