Chaînes de format de date et d'heure personnaliséesCustom Date and Time Format Strings

Une chaîne de format de date et d'heure définit la représentation textuelle d'une valeur DateTime ou DateTimeOffset qui résulte d'une opération de mise en forme.A date and time format string defines the text representation of a DateTime or DateTimeOffset value that results from a formatting operation . Elle peut également définir la représentation d'une valeur de date et d'heure qui est requise dans une opération d'analyse afin de convertir correctement la chaîne sous forme de date et d'heure.It can also define the representation of a date and time value that is required in a parsing operation in order to successfully convert the string to a date and time. Une chaîne de format personnalisée se compose d'un ou de plusieurs spécificateurs de format de date et d'heure personnalisés.A custom format string consists of one or more custom date and time format specifiers. Toute chaîne autre qu’une chaîne de format de date et d’heure standard est interprétée comme une chaîne de format de date et d’heure personnalisée.Any string that is not a standard date and time format string is interpreted as a custom date and time format string.

Conseil

Vous pouvez télécharger l’utilitaire de mise en forme, une application qui vous permet d’appliquer des chaînes de format à 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, an application that enables you to apply format strings to either date and time or numeric values and displays the result string.

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

Note

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.

Dans les opérations de mise en forme, les chaînes de format de date et d'heure personnalisées peuvent être utilisées avec la méthode ToString d'une instance de date et d'heure ou avec une méthode qui prend en charge la mise en forme composite.In formatting operations, custom date and time format strings can be used either with the ToString method of a date and time instance or with a method that supports composite formatting. L'exemple suivant illustre ces deux types d'utilisation.The following example illustrates both uses.

DateTime thisDate1 = new DateTime(2011, 6, 10);
Console.WriteLine("Today is " + thisDate1.ToString("MMMM dd, yyyy") + ".");
 
DateTimeOffset thisDate2 = new DateTimeOffset(2011, 6, 10, 15, 24, 16, 
                                              TimeSpan.Zero);
Console.WriteLine("The current date and time: {0:MM/dd/yy H:mm:ss zzz}", 
                   thisDate2); 
// The example displays the following output:
//    Today is June 10, 2011.
//    The current date and time: 06/10/11 15:24:16 +00:00
 Dim thisDate1 As Date = #6/10/2011#
 Console.WriteLine("Today is " + thisDate1.ToString("MMMM dd, yyyy") + ".")
 
 Dim thisDate2 As New DateTimeOffset(2011, 6, 10, 15, 24, 16, TimeSpan.Zero)
 Console.WriteLine("The current date and time: {0:MM/dd/yy H:mm:ss zzz}", 
                   thisDate2) 
 ' The example displays the following output:
'    Today is June 10, 2011.
'    The current date and time: 06/10/11 15:24:16 +00:00

Dans les opérations d'analyse, les chaînes de format de date et d'heure personnalisées peuvent être utilisées avec les méthodes DateTime.ParseExact, DateTime.TryParseExact, DateTimeOffset.ParseExact et DateTimeOffset.TryParseExact.In parsing operations, custom date and time format strings can be used with the DateTime.ParseExact, DateTime.TryParseExact, DateTimeOffset.ParseExact, and DateTimeOffset.TryParseExact methods. 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.These methods require that an input string conform exactly to a particular pattern for the parse operation to succeed. L'exemple suivant illustre un appel à la méthode DateTimeOffset.ParseExact(String, String, IFormatProvider) pour analyser une date qui doit comprendre un jour, un mois et une année sur deux chiffres.The following example illustrates a call to the DateTimeOffset.ParseExact(String, String, IFormatProvider) method to parse a date that must include a day, a month, and a two-digit year.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] dateValues = { "30-12-2011", "12-30-2011", 
                              "30-12-11", "12-30-11" };
      string pattern = "MM-dd-yy";
      DateTime parsedDate;
      
      foreach (var dateValue in dateValues) {
         if (DateTime.TryParseExact(dateValue, pattern, null, 
                                   DateTimeStyles.None, out parsedDate))
            Console.WriteLine("Converted '{0}' to {1:d}.", 
                              dateValue, parsedDate);
         else
            Console.WriteLine("Unable to convert '{0}' to a date and time.", 
                              dateValue);
      }
   }
}
// The example displays the following output:
//    Unable to convert '30-12-2011' to a date and time.
//    Unable to convert '12-30-2011' to a date and time.
//    Unable to convert '30-12-11' to a date and time.
//    Converted '12-30-11' to 12/30/2011.
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim dateValues() As String = { "30-12-2011", "12-30-2011", 
                                      "30-12-11", "12-30-11" }
      Dim pattern As String = "MM-dd-yy"
      Dim parsedDate As Date
      
      For Each dateValue As String In dateValues
         If DateTime.TryParseExact(dateValue, pattern, Nothing, 
                                   DateTimeStyles.None, parsedDate) Then
            Console.WriteLine("Converted '{0}' to {1:d}.", 
                              dateValue, parsedDate)
         Else
            Console.WriteLine("Unable to convert '{0}' to a date and time.", 
                              dateValue)
         End If                                                         
      Next
   End Sub
End Module
' The example displays the following output:
'    Unable to convert '30-12-2011' to a date and time.
'    Unable to convert '12-30-2011' to a date and time.
'    Unable to convert '30-12-11' to a date and time.
'    Converted '12-30-11' to 12/30/2011.

Le tableau suivant décrit les spécificateurs de format de date et d'heure personnalisés et affiche une chaîne de résultat produite par chaque spécificateur de format.The following table describes the custom date and time format specifiers and displays a result string produced by each format specifier. Par défaut, les chaînes de résultat reflètent les conventions de mise en forme de la culture en-US.By default, result strings reflect the formatting conventions of the en-US culture. Si un spécificateur de format particulier produit une chaîne de résultat localisée, l'exemple indique également la culture à laquelle la chaîne de résultat s'applique.If a particular format specifier produces a localized result string, the example also notes the culture to which the result string applies. Pour plus d'informations sur l'utilisation de chaînes de format de date et d'heure personnalisées, consultez la section Remarques.See the Notes section for additional information about using custom date and time format strings.

Spécificateur de formatFormat specifier DescriptionDescription ExemplesExamples
"d""d" Jour du mois, de 1 à 31.The day of the month, from 1 through 31.

Informations supplémentaires : Spécificateur de format personnalisé "d".More information: The "d" Custom Format Specifier.
2009-06-01T13:45:30 -> 12009-06-01T13:45:30 -> 1

2009-06-15T13:45:30 -> 152009-06-15T13:45:30 -> 15
"dd""dd" Jour du mois, de 01 à 31.The day of the month, from 01 through 31.

Informations supplémentaires : Spécificateur de format personnalisé "dd".More information: The "dd" Custom Format Specifier.
2009-06-01T13:45:30 -> 012009-06-01T13:45:30 -> 01

2009-06-15T13:45:30 -> 152009-06-15T13:45:30 -> 15
"ddd""ddd" Nom abrégé du jour de la semaine.The abbreviated name of the day of the week.

Informations supplémentaires : Spécificateur de format personnalisé "ddd".More information: The "ddd" Custom Format Specifier.
2009-06-15T13:45:30 -> Mon (en-US)2009-06-15T13:45:30 -> Mon (en-US)

2009-06-15T13:45:30 -> Пн (ru-RU)2009-06-15T13:45:30 -> Пн (ru-RU)

2009-06-15T13:45:30 -> lun.2009-06-15T13:45:30 -> lun. (fr-FR)(fr-FR)
"dddd""dddd" Nom complet du jour de la semaine.The full name of the day of the week.

Informations supplémentaires : Spécificateur de format personnalisé "dddd".More information: The "dddd" Custom Format Specifier.
2009-06-15T13:45:30 -> Monday (en-US)2009-06-15T13:45:30 -> Monday (en-US)

2009-06-15T13:45:30 -> понедельник (ru-RU)2009-06-15T13:45:30 -> понедельник (ru-RU)

2009-06-15T13:45:30 -> lundi (fr-FR)2009-06-15T13:45:30 -> lundi (fr-FR)
"f""f" Dixièmes de seconde dans une valeur de date et d'heure.The tenths of a second in a date and time value.

Informations supplémentaires : Spécificateur de format personnalisé "f".More information: The "f" Custom Format Specifier.
2009-06-15T13:45:30.6170000 -> 62009-06-15T13:45:30.6170000 -> 6

2009-06-15T13:45:30.05 -> 02009-06-15T13:45:30.05 -> 0
"ff""ff" Centièmes de seconde dans une valeur de date et d'heure.The hundredths of a second in a date and time value.

Informations supplémentaires : Spécificateur de format personnalisé "FF".More information: The "ff" Custom Format Specifier.
2009-06-15T13:45:30.6170000 -> 612009-06-15T13:45:30.6170000 -> 61

2009-06-15T13:45:30.0050000 -> 002009-06-15T13:45:30.0050000 -> 00
"fff""fff" Millisecondes dans une valeur de date et d'heure.The milliseconds in a date and time value.

Informations supplémentaires : Spécificateur de format personnalisé "fff".More information: The "fff" Custom Format Specifier.
6/15/2009 13:45:30.617 -> 6176/15/2009 13:45:30.617 -> 617

6/15/2009 13:45:30.0005 -> 0006/15/2009 13:45:30.0005 -> 000
"ffff""ffff" Dix millièmes de seconde dans une valeur de date et d'heure.The ten thousandths of a second in a date and time value.

Informations supplémentaires : Spécificateur de format personnalisé "ffff".More information: The "ffff" Custom Format Specifier.
2009-06-15T13:45:30.6175000 -> 61752009-06-15T13:45:30.6175000 -> 6175

2009-06-15T13:45:30.0000500 -> 00002009-06-15T13:45:30.0000500 -> 0000
"fffff""fffff" Cent millièmes de seconde dans une valeur de date et d'heure.The hundred thousandths of a second in a date and time value.

Informations supplémentaires : Spécificateur de format personnalisé "fffff".More information: The "fffff" Custom Format Specifier.
2009-06-15T13:45:30.6175400 -> 617542009-06-15T13:45:30.6175400 -> 61754

6/15/2009 13:45:30.000005 -> 000006/15/2009 13:45:30.000005 -> 00000
"ffffff""ffffff" Millionièmes de seconde dans une valeur de date et d'heure.The millionths of a second in a date and time value.

Informations supplémentaires : Spécificateur de format personnalisé "ffffff".More information: The "ffffff" Custom Format Specifier.
2009-06-15T13:45:30.6175420 -> 6175422009-06-15T13:45:30.6175420 -> 617542

2009-06-15T13:45:30.0000005 -> 0000002009-06-15T13:45:30.0000005 -> 000000
"fffffff""fffffff" Dix millionièmes de seconde dans une valeur de date et d'heure.The ten millionths of a second in a date and time value.

Informations supplémentaires : Spécificateur de format personnalisé "fffffff".More information: The "fffffff" Custom Format Specifier.
2009-06-15T13:45:30.6175425 -> 61754252009-06-15T13:45:30.6175425 -> 6175425

2009-06-15T13:45:30.0001150 -> 00011502009-06-15T13:45:30.0001150 -> 0001150
"F""F" Si la valeur est différente de zéro, elle représente les dixièmes de seconde dans une valeur de date et d'heure.If non-zero, the tenths of a second in a date and time value.

Informations supplémentaires : Spécificateur de format personnalisé "F".More information: The "F" Custom Format Specifier.
2009-06-15T13:45:30.6170000 -> 62009-06-15T13:45:30.6170000 -> 6

2009-06-15T13:45:30.0500000 -> (pas de sortie)2009-06-15T13:45:30.0500000 -> (no output)
"FF""FF" Si la valeur est différente de zéro, elle représente les centièmes de seconde dans une valeur de date et d'heure.If non-zero, the hundredths of a second in a date and time value.

Informations supplémentaires : Spécificateur de format personnalisé "FF".More information: The "FF" Custom Format Specifier.
2009-06-15T13:45:30.6170000 -> 612009-06-15T13:45:30.6170000 -> 61

2009-06-15T13:45:30.0050000 -> (pas de sortie)2009-06-15T13:45:30.0050000 -> (no output)
"FFF""FFF" Si la valeur est différente de zéro, elle représente les millisecondes dans une valeur de date et d'heure.If non-zero, the milliseconds in a date and time value.

Informations supplémentaires : Spécificateur de format personnalisé "FFF".More information: The "FFF" Custom Format Specifier.
2009-06-15T13:45:30.6170000 -> 6172009-06-15T13:45:30.6170000 -> 617

2009-06-15T13:45:30.0005000 -> (pas de sortie)2009-06-15T13:45:30.0005000 -> (no output)
"FFFF""FFFF" Si la valeur est différente de zéro, elle représente les dix millièmes de seconde dans une valeur de date et d'heure.If non-zero, the ten thousandths of a second in a date and time value.

Informations supplémentaires : Spécificateur de format personnalisé "FFFF".More information: The "FFFF" Custom Format Specifier.
2009-06-15T13:45:30.5275000 -> 52752009-06-15T13:45:30.5275000 -> 5275

2009-06-15T13:45:30.0000500 -> (pas de sortie)2009-06-15T13:45:30.0000500 -> (no output)
"FFFFF""FFFFF" Si la valeur est différente de zéro, elle représente les cent millièmes de seconde dans une valeur de date et d'heure.If non-zero, the hundred thousandths of a second in a date and time value.

Informations supplémentaires : Spécificateur de format personnalisé "FFFFF".More information: The "FFFFF" Custom Format Specifier.
2009-06-15T13:45:30.6175400 -> 617542009-06-15T13:45:30.6175400 -> 61754

2009-06-15T13:45:30.0000050 -> (pas de sortie)2009-06-15T13:45:30.0000050 -> (no output)
"FFFFFF""FFFFFF" Si la valeur est différente de zéro, elle représente les millionièmes de seconde dans une valeur de date et d'heure.If non-zero, the millionths of a second in a date and time value.

Informations supplémentaires : Spécificateur de format personnalisé "FFFFFF".More information: The "FFFFFF" Custom Format Specifier.
2009-06-15T13:45:30.6175420 -> 6175422009-06-15T13:45:30.6175420 -> 617542

2009-06-15T13:45:30.0000005 -> (pas de sortie)2009-06-15T13:45:30.0000005 -> (no output)
"FFFFFFF""FFFFFFF" Si la valeur est différente de zéro, elle représente les dix millionièmes de seconde dans une valeur de date et d'heure.If non-zero, the ten millionths of a second in a date and time value.

Informations supplémentaires : Spécificateur de format personnalisé "FFFFFFF".More information: The "FFFFFFF" Custom Format Specifier.
2009-06-15T13:45:30.6175425 -> 61754252009-06-15T13:45:30.6175425 -> 6175425

2009-06-15T13:45:30.0001150 -> 0001152009-06-15T13:45:30.0001150 -> 000115
"g", "gg""g", "gg" Période ou ère.The period or era.

Informations supplémentaires : Spécificateur de format personnalisé "g" ou "gg".More information: The "g" or "gg" Custom Format Specifier.
2009-06-15T13:45:30.6170000 -> A.D.2009-06-15T13:45:30.6170000 -> A.D.
"h""h" Heure, au format de 12 heures, de 1 à 12.The hour, using a 12-hour clock from 1 to 12.

Informations supplémentaires : Spécificateur de format personnalisé "h".More information: The "h" Custom Format Specifier.
2009-06-15T01:45:30 -> 12009-06-15T01:45:30 -> 1

2009-06-15T13:45:30 -> 12009-06-15T13:45:30 -> 1
"hh""hh" Heure, au format de 12 heures, de 01 à 12.The hour, using a 12-hour clock from 01 to 12.

Informations supplémentaires : Spécificateur de format personnalisé "hh".More information: The "hh" Custom Format Specifier.
2009-06-15T01:45:30 -> 012009-06-15T01:45:30 -> 01

2009-06-15T13:45:30 -> 012009-06-15T13:45:30 -> 01
"H""H" Heure, au format de 24 heures, de 0 à 23.The hour, using a 24-hour clock from 0 to 23.

Informations supplémentaires : Spécificateur de format personnalisé "H".More information: The "H" Custom Format Specifier.
2009-06-15T01:45:30 -> 12009-06-15T01:45:30 -> 1

2009-06-15T13:45:30 -> 132009-06-15T13:45:30 -> 13
"HH""HH" Heure, au format de 24 heures, de 00 à 23.The hour, using a 24-hour clock from 00 to 23.

Informations supplémentaires : Spécificateur de format personnalisé "HH".More information: The "HH" Custom Format Specifier.
2009-06-15T01:45:30 -> 012009-06-15T01:45:30 -> 01

2009-06-15T13:45:30 -> 132009-06-15T13:45:30 -> 13
"K""K" Informations de fuseau horaire.Time zone information.

Informations supplémentaires : Spécificateur de format personnalisé "K".More information: The "K" Custom Format Specifier.
Avec les valeurs DateTime :With DateTime values:

2009-06-15T13:45:30, Kind Unspecified ->2009-06-15T13:45:30, Kind Unspecified ->

2009-06-15T13:45:30, Kind Utc -> Z2009-06-15T13:45:30, Kind Utc -> Z

2009-06-15T13:45:30, Kind Local -> -07:00 (dépend des paramètres de l'ordinateur local)2009-06-15T13:45:30, Kind Local -> -07:00 (depends on local computer settings)

Avec les valeurs DateTimeOffset :With DateTimeOffset values:

2009-06-15T01:45:30-07:00 --> -07:002009-06-15T01:45:30-07:00 --> -07:00

2009-06-15T08:45:30+00:00 --> +00:002009-06-15T08:45:30+00:00 --> +00:00
"m""m" Minute, définie entre 0 et 59.The minute, from 0 through 59.

Informations supplémentaires : Spécificateur de format personnalisé "m".More information: The "m" Custom Format Specifier.
2009-06-15T01:09:30 -> 92009-06-15T01:09:30 -> 9

2009-06-15T13:29:30 -> 292009-06-15T13:29:30 -> 29
"mm""mm" Minute, définie entre 00 et 59.The minute, from 00 through 59.

Informations supplémentaires : Spécificateur de format personnalisé "mm".More information: The "mm" Custom Format Specifier.
2009-06-15T01:09:30 -> 092009-06-15T01:09:30 -> 09

2009-06-15T01:45:30 -> 452009-06-15T01:45:30 -> 45
"M""M" Mois, de 1 à 12.The month, from 1 through 12.

Informations supplémentaires : Spécificateur de format personnalisé "M".More information: The "M" Custom Format Specifier.
2009-06-15T13:45:30 -> 62009-06-15T13:45:30 -> 6
"MM""MM" Mois, de 01 à 12.The month, from 01 through 12.

Informations supplémentaires : Spécificateur de format personnalisé "MM".More information: The "MM" Custom Format Specifier.
2009-06-15T13:45:30 -> 062009-06-15T13:45:30 -> 06
"MMM""MMM" Nom abrégé du mois.The abbreviated name of the month.

Informations supplémentaires : Spécificateur de format personnalisé "MMM".More information: The "MMM" Custom Format Specifier.
2009-06-15T13:45:30 -> Jun (en-US)2009-06-15T13:45:30 -> Jun (en-US)

2009-06-15T13:45:30 -> juin (fr-FR)2009-06-15T13:45:30 -> juin (fr-FR)

2009-06-15T13:45:30 -> Jun (zu-ZA)2009-06-15T13:45:30 -> Jun (zu-ZA)
"MMMM""MMMM" Nom complet du mois.The full name of the month.

Informations supplémentaires : Spécificateur de format personnalisé "MMMM".More information: The "MMMM" Custom Format Specifier.
2009-06-15T13:45:30 -> June (en-US)2009-06-15T13:45:30 -> June (en-US)

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

2009-06-15T13:45:30 -> uJuni (zu-ZA)2009-06-15T13:45:30 -> uJuni (zu-ZA)
"s""s" Seconde, de 0 à 59.The second, from 0 through 59.

Informations supplémentaires : Spécificateur de format personnalisé "s".More information: The "s" Custom Format Specifier.
2009-06-15T13:45:09 -> 92009-06-15T13:45:09 -> 9
"ss""ss" Seconde, de 00 à 59.The second, from 00 through 59.

Informations supplémentaires : Spécificateur de format personnalisé "ss".More information: The "ss" Custom Format Specifier.
2009-06-15T13:45:09 -> 092009-06-15T13:45:09 -> 09
"t""t" Premier caractère de l'indicateur AM/PM.The first character of the AM/PM designator.

Informations supplémentaires : Spécificateur de format personnalisé "t".More information: The "t" Custom Format Specifier.
2009-06-15T13:45:30 -> P (en-US)2009-06-15T13:45:30 -> P (en-US)

2009-06-15T13:45:30 -> 午 (ja-JP)2009-06-15T13:45:30 -> 午 (ja-JP)

2009-06-15T13:45:30 -> (fr-FR)2009-06-15T13:45:30 -> (fr-FR)
"tt""tt" Indicateur AM/PM.The AM/PM designator.

Informations supplémentaires : Spécificateur de format personnalisé "tt".More information: The "tt" Custom Format Specifier.
2009-06-15T13:45:30 -> PM (en-US)2009-06-15T13:45:30 -> PM (en-US)

2009-06-15T13:45:30 -> 午後 (ja-JP)2009-06-15T13:45:30 -> 午後 (ja-JP)

2009-06-15T13:45:30 -> (fr-FR)2009-06-15T13:45:30 -> (fr-FR)
"y""y" Année, de 0 à 99.The year, from 0 to 99.

Informations supplémentaires : Spécificateur de format personnalisé "y".More information: The "y" Custom Format Specifier.
0001-01-01T00:00:00 -> 10001-01-01T00:00:00 -> 1

0900-01-01T00:00:00 -> 00900-01-01T00:00:00 -> 0

1900-01-01T00:00:00 -> 01900-01-01T00:00:00 -> 0

2009-06-15T13:45:30 -> 92009-06-15T13:45:30 -> 9

2019-06-15T13:45:30 -> 192019-06-15T13:45:30 -> 19
"yy""yy" Année, de 00 à 99.The year, from 00 to 99.

Informations supplémentaires : Spécificateur de format personnalisé "yy".More information: The "yy" Custom Format Specifier.
0001-01-01T00:00:00 -> 010001-01-01T00:00:00 -> 01

0900-01-01T00:00:00 -> 000900-01-01T00:00:00 -> 00

1900-01-01T00:00:00 -> 001900-01-01T00:00:00 -> 00

2019-06-15T13:45:30 -> 192019-06-15T13:45:30 -> 19
"yyy""yyy" Année, avec au minimum trois chiffres.The year, with a minimum of three digits.

Informations supplémentaires : Spécificateur de format personnalisé "yyy".More information: The "yyy" Custom Format Specifier.
0001-01-01T00:00:00 -> 0010001-01-01T00:00:00 -> 001

0900-01-01T00:00:00 -> 9000900-01-01T00:00:00 -> 900

1900-01-01T00:00:00 -> 19001900-01-01T00:00:00 -> 1900

2009-06-15T13:45:30 -> 20092009-06-15T13:45:30 -> 2009
"yyyy""yyyy" Année, en tant que nombre à quatre chiffres.The year as a four-digit number.

Informations supplémentaires : Spécificateur de format personnalisé "yyyy".More information: The "yyyy" Custom Format Specifier.
0001-01-01T00:00:00 -> 00010001-01-01T00:00:00 -> 0001

0900-01-01T00:00:00 -> 09000900-01-01T00:00:00 -> 0900

1900-01-01T00:00:00 -> 19001900-01-01T00:00:00 -> 1900

2009-06-15T13:45:30 -> 20092009-06-15T13:45:30 -> 2009
"yyyyy""yyyyy" Année, en tant que nombre à cinq chiffres.The year as a five-digit number.

Informations supplémentaires : Spécificateur de format personnalisé "yyyyy".More information: The "yyyyy" Custom Format Specifier.
0001-01-01T00:00:00 -> 000010001-01-01T00:00:00 -> 00001

2009-06-15T13:45:30 -> 020092009-06-15T13:45:30 -> 02009
"z""z" Décalage horaire par rapport à l'heure UTC, sans zéro non significatif.Hours offset from UTC, with no leading zeros.

Informations supplémentaires : Spécificateur de format personnalisé "z".More information: The "z" Custom Format Specifier.
2009-06-15T13:45:30-07:00 -> -72009-06-15T13:45:30-07:00 -> -7
"zz""zz" Décalage horaire par rapport à l'heure UTC, avec un zéro non significatif pour une valeur à un seul chiffre.Hours offset from UTC, with a leading zero for a single-digit value.

Informations supplémentaires : Spécificateur de format personnalisé "zz".More information: The "zz" Custom Format Specifier.
2009-06-15T13:45:30-07:00 -> -072009-06-15T13:45:30-07:00 -> -07
"zzz""zzz" Décalage horaire par rapport à l'heure UTC, en heures et minutes.Hours and minutes offset from UTC.

Informations supplémentaires : Spécificateur de format personnalisé "zzz".More information: The "zzz" Custom Format Specifier.
2009-06-15T13:45:30-07:00 -> -07:002009-06-15T13:45:30-07:00 -> -07:00
":"":" Séparateur horaire.The time separator.

Informations supplémentaires : Spécificateur de format personnalisé ":".More information: The ":" Custom Format Specifier.
2009-06-15T13:45:30 -> : (en-US)2009-06-15T13:45:30 -> : (en-US)

2009-06-15T13:45:30 -> .2009-06-15T13:45:30 -> . (it-IT)(it-IT)

2009-06-15T13:45:30 -> : (ja-JP)2009-06-15T13:45:30 -> : (ja-JP)
"/""/" Séparateur de date.The date separator.

Informations supplémentaires : Spécificateur de format personnalisé "/".More Information: The "/" Custom Format Specifier.
2009-06-15T13:45:30 -> / (en-US)2009-06-15T13:45:30 -> / (en-US)

2009-06-15T13:45:30 -> - (ar-DZ)2009-06-15T13:45:30 -> - (ar-DZ)

2009-06-15T13:45:30 -> .2009-06-15T13:45:30 -> . (tr-TR)(tr-TR)
"chaîne""string"

'chaîne''string'
Délimiteur de chaîne littérale.Literal string delimiter.

Plus d’informations : Littéraux de caractère.More information: Character literals.
2009-06-15T13:45:30 ("arr:" h:m t) -> arr: 1:45 P2009-06-15T13:45:30 ("arr:" h:m t) -> arr: 1:45 P

2009-06-15T13:45:30 ('arr:' h:m t) -> arr: 1:45 P2009-06-15T13:45:30 ('arr:' h:m t) -> arr: 1:45 P
% Définit le caractère suivant comme spécificateur de format personnalisé.Defines the following character as a custom format specifier.

Informations supplémentaires : Utilisation de spécificateurs de format personnalisés uniques.More information:Using Single Custom Format Specifiers.
2009-06-15T13:45:30 (%h) -> 12009-06-15T13:45:30 (%h) -> 1
\\ Caractère d'échappement.The escape character.

Plus d’informations : Littéraux de caractère et Utilisation du caractère d’échappement.More information: Character literals and Using the Escape Character.
2009-06-15T13:45:30 (h \h) -> 1 h2009-06-15T13:45:30 (h \h) -> 1 h
N'importe quel autre caractèreAny other character Le caractère est copié inchangé dans la chaîne de résultat.The character is copied to the result string unchanged.

Plus d’informations : Littéraux de caractère.More information: Character literals.
2009-06-15T01:45:30 (arr hh:mm t) -> arr 01:45 A2009-06-15T01:45:30 (arr hh:mm t) -> arr 01:45 A

Les sections suivantes fournissent des informations supplémentaires sur chaque spécificateur de format de date et d'heure personnalisé.The following sections provide additional information about each custom date and time format specifier. Sauf indication contraire, chaque spécificateur produit une représentation sous forme de chaîne identique, qu'il soit utilisé avec une valeur DateTime ou une valeur DateTimeOffset.Unless otherwise noted, each specifier produces an identical string representation regardless of whether it is used with a DateTime value or a DateTimeOffset value.

Spécificateur de format personnalisé "d"The "d" custom format specifier

Le spécificateur de format personnalisé "d" représente le jour du mois sous la forme d'un nombre compris entre 1 et 31.The "d" custom format specifier represents the day of the month as a number from 1 through 31. Un jour à un seul chiffre est mis en forme sans zéro non significatif.A single-digit day is formatted without a leading zero.

Si le spécificateur de format "d" est utilisé sans autre spécificateur de format personnalisé, il est interprété comme le spécificateur de format de date et d'heure standard "d".If the "d" format specifier is used without other custom format specifiers, it is interpreted as the "d" standard date and time format specifier. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques, plus loin dans cette rubrique.For more information about using a single format specifier, see Using Single Custom Format Specifiers later in this topic.

L'exemple suivant inclut le spécificateur de format personnalisé "d" dans plusieurs chaînes de format.The following example includes the "d" custom format specifier in several format strings.

DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15); 

Console.WriteLine(date1.ToString("d, M", 
                  CultureInfo.InvariantCulture)); 
// Displays 29, 8

Console.WriteLine(date1.ToString("d MMMM", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays 29 August
Console.WriteLine(date1.ToString("d MMMM", 
                  CultureInfo.CreateSpecificCulture("es-MX")));
// Displays 29 agosto                                                
Dim date1 As Date = #08/29/2008 7:27:15PM#

Console.WriteLine(date1.ToString("d, M", _
                  CultureInfo.InvariantCulture)) 
' Displays 29, 8

Console.WriteLine(date1.ToString("d MMMM", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays 29 August
Console.WriteLine(date1.ToString("d MMMM", _
                  CultureInfo.CreateSpecificCulture("es-MX")))
' Displays 29 agosto                                                

Retour au tableauBack to table

Spécificateur de format personnalisé "dd"The "dd" custom format specifier

Le spécificateur de format personnalisé "dd" représente le jour du mois sous la forme d'un nombre compris entre 01 et 31.The "dd" custom format string represents the day of the month as a number from 01 through 31. Un jour à un seul chiffre est mis en forme avec un zéro non significatif.A single-digit day is formatted with a leading zero.

L'exemple suivant inclut le spécificateur de format personnalisé "dd" dans une chaîne de format personnalisée.The following example includes the "dd" custom format specifier in a custom format string.

DateTime date1 = new DateTime(2008, 1, 2, 6, 30, 15);

Console.WriteLine(date1.ToString("dd, MM", 
                  CultureInfo.InvariantCulture)); 
// 02, 01
Dim date1 As Date = #1/2/2008 6:30:15AM#

Console.WriteLine(date1.ToString("dd, MM", _
                  CultureInfo.InvariantCulture)) 
' 02, 01

Retour au tableauBack to table

Spécificateur de format personnalisé "ddd"The "ddd" custom format specifier

Le spécificateur de format personnalisé "ddd" représente le nom abrégé du jour de la semaine.The "ddd" custom format specifier represents the abbreviated name of the day of the week. Le nom abrégé localisé du jour de la semaine est récupéré de la propriété DateTimeFormatInfo.AbbreviatedDayNames de la culture actuelle ou spécifiée.The localized abbreviated name of the day of the week is retrieved from the DateTimeFormatInfo.AbbreviatedDayNames property of the current or specified culture.

L'exemple suivant inclut le spécificateur de format personnalisé "ddd" dans une chaîne de format personnalisée.The following example includes the "ddd" custom format specifier in a custom format string.

DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);

Console.WriteLine(date1.ToString("ddd d MMM", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM", 
                  CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays ven. 29 août                                                
Dim date1 As Date = #08/29/2008 7:27:15PM#

Console.WriteLine(date1.ToString("ddd d MMM", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM", _
                  CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays ven. 29 août                                                

Retour au tableauBack to table

Spécificateur de format personnalisé "dddd"The "dddd" custom format specifier

Le spécificateur de format personnalisé "dddd" (plus n'importe quel nombre de spécificateurs "d" supplémentaires) représente le nom complet du jour de la semaine.The "dddd" custom format specifier (plus any number of additional "d" specifiers) represents the full name of the day of the week. Le nom localisé du jour de la semaine est récupéré de la propriété DateTimeFormatInfo.DayNames de la culture actuelle ou spécifiée.The localized name of the day of the week is retrieved from the DateTimeFormatInfo.DayNames property of the current or specified culture.

L'exemple suivant inclut le spécificateur de format personnalisé "dddd" dans une chaîne de format personnalisée.The following example includes the "dddd" custom format specifier in a custom format string.

DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);

Console.WriteLine(date1.ToString("dddd dd MMMM", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM", 
                  CultureInfo.CreateSpecificCulture("it-IT")));
// Displays venerdì 29 agosto                                
Dim date1 As Date = #08/29/2008 7:27:15PM#

Console.WriteLine(date1.ToString("dddd dd MMMM", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM", _
                  CultureInfo.CreateSpecificCulture("it-IT")))
' Displays venerdì 29 agosto                                          

Retour au tableauBack to table

Spécificateur de format personnalisé "f"The "f" custom format specifier

Le spécificateur de format personnalisé "f" représente le chiffre le plus significatif de la fraction de seconde ; autrement dit, il représente les dixièmes de seconde dans une valeur de date et d'heure.The "f" custom format specifier represents the most significant digit of the seconds fraction; that is, it represents the tenths of a second in a date and time value.

Si le spécificateur de format "f" est utilisé sans autre spécificateur de format, il est interprété comme le spécificateur de format de date et d'heure standard "f".If the "f" format specifier is used without other format specifiers, it is interpreted as the "f" standard date and time format specifier. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques, plus loin dans cette rubrique.For more information about using a single format specifier, see Using Single Custom Format Specifiers later in this topic.

Lorsque vous utilisez "f" dans le cadre d'une chaîne de format fournie à la méthode ParseExact, TryParseExact, ParseExact ou TryParseExact, le nombre de spécificateurs de format "f" utilisés indique le nombre des chiffres les plus significatifs de la fraction de seconde requis pour analyser correctement la chaîne.When you use "f" format specifiers as part of a format string supplied to the ParseExact, TryParseExact, ParseExact, or TryParseExact method, the number of "f" format specifiers indicates the number of most significant digits of the seconds fraction that must be present to successfully parse the string.

L'exemple suivant inclut le spécificateur de format personnalisé "f" dans une chaîne de format personnalisée.The following example includes the "f" custom format specifier in a custom format string.

DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;

Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture

Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018

Retour au tableauBack to table

Spécificateur de format personnalisé "ff"The "ff" custom format specifier

Le spécificateur de format personnalisé "ff" représente les deux chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les centièmes de seconde dans une valeur de date et d'heure.The "ff" custom format specifier represents the two most significant digits of the seconds fraction; that is, it represents the hundredths of a second in a date and time value.

L'exemple suivant inclut le spécificateur de format personnalisé "ff" dans une chaîne de format personnalisée.following example includes the "ff" custom format specifier in a custom format string.

DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;

Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture

Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018

Retour au tableauBack to table

Spécificateur de format personnalisé "fff"The "fff" custom format specifier

Le spécificateur de format personnalisé "fff" représente les trois chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les millisecondes dans une valeur de date et d'heure.The "fff" custom format specifier represents the three most significant digits of the seconds fraction; that is, it represents the milliseconds in a date and time value.

L'exemple suivant inclut le spécificateur de format personnalisé "fff" dans une chaîne de format personnalisée.The following example includes the "fff" custom format specifier in a custom format string.

DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;

Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture

Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018

Retour au tableauBack to table

Spécificateur de format personnalisé "ffff"The "ffff" custom format specifier

Le spécificateur de format personnalisé "ffff" représente les quatre chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les dix millièmes de seconde dans une valeur de date et d'heure.The "ffff" custom format specifier represents the four most significant digits of the seconds fraction; that is, it represents the ten thousandths of a second in a date and time value.

Bien qu'il soit possible d'afficher les dix millièmes du composant "secondes" d'une valeur d'heure, cette valeur peut ne pas être significative.Although it is possible to display the ten thousandths of a second component of a time value, that value may not be meaningful. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système.The precision of date and time values depends on the resolution of the system clock. Sur les systèmes d’exploitation Windows NT version 3.5 (et ultérieures) et Windows Vista, la résolution de l’horloge est d’environ 10-15 millisecondes.On the Windows NT version 3.5 (and later) and Windows Vista operating systems, the clock's resolution is approximately 10-15 milliseconds.

Retour au tableauBack to table

Spécificateur de format personnalisé "fffff"The "fffff" custom format specifier

Le spécificateur de format personnalisé "fffff" représente les cinq chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les cent millièmes de seconde dans une valeur de date et d'heure.The "fffff" custom format specifier represents the five most significant digits of the seconds fraction; that is, it represents the hundred thousandths of a second in a date and time value.

Bien qu'il soit possible d'afficher les cent millièmes du composant "secondes" d'une valeur d'heure, cette valeur peut ne pas être significative.Although it is possible to display the hundred thousandths of a second component of a time value, that value may not be meaningful. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système.The precision of date and time values depends on the resolution of the system clock. Sur les systèmes d’exploitation Windows NT 3.5 (et versions ultérieures) et Windows Vista, la résolution de l’horloge est d’environ 10-15 millisecondes.On the Windows NT 3.5 (and later) and Windows Vista operating systems, the clock's resolution is approximately 10-15 milliseconds.

Retour au tableauBack to table

Spécificateur de format personnalisé "ffffff"The "ffffff" custom format specifier

Le spécificateur de format personnalisé "ffffff" représente les six chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les millionièmes de seconde dans une valeur de date et d'heure.The "ffffff" custom format specifier represents the six most significant digits of the seconds fraction; that is, it represents the millionths of a second in a date and time value.

Bien qu'il soit possible d'afficher les millionièmes du composant "secondes" d'une valeur d'heure, cette valeur peut ne pas être significative.Although it is possible to display the millionths of a second component of a time value, that value may not be meaningful. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système.The precision of date and time values depends on the resolution of the system clock. Sur les systèmes d’exploitation Windows NT 3.5 (et versions ultérieures) et Windows Vista, la résolution de l’horloge est d’environ 10-15 millisecondes.On the Windows NT 3.5 (and later) and Windows Vista operating systems, the clock's resolution is approximately 10-15 milliseconds.

Retour au tableauBack to table

Spécificateur de format personnalisé "fffffff"The "fffffff" custom format specifier

Le spécificateur de format personnalisé "fffffff" représente les sept chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les dix millionièmes de seconde dans une valeur de date et d'heure.The "fffffff" custom format specifier represents the seven most significant digits of the seconds fraction; that is, it represents the ten millionths of a second in a date and time value.

Bien qu'il soit possible d'afficher les dix millionièmes du composant "secondes" d'une valeur d'heure, cette valeur peut ne pas être significative.Although it is possible to display the ten millionths of a second component of a time value, that value may not be meaningful. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système.The precision of date and time values depends on the resolution of the system clock. Sur les systèmes d’exploitation Windows NT 3.5 (et versions ultérieures) et Windows Vista, la résolution de l’horloge est d’environ 10-15 millisecondes.On the Windows NT 3.5 (and later) and Windows Vista operating systems, the clock's resolution is approximately 10-15 milliseconds.

Retour au tableauBack to table

Spécificateur de format personnalisé "F"The "F" custom format specifier

Le spécificateur de format personnalisé "F" représente le chiffre le plus significatif de la fraction de seconde ; autrement dit, il représente les dixièmes de seconde dans une valeur de date et d'heure.The "F" custom format specifier represents the most significant digit of the seconds fraction; that is, it represents the tenths of a second in a date and time value. Rien ne s'affiche si le chiffre est zéro.Nothing is displayed if the digit is zero.

Si le spécificateur de format "F" est utilisé sans autre spécificateur de format, il est interprété comme le spécificateur de format de date et d'heure standard "F".If the "F" format specifier is used without other format specifiers, it is interpreted as the "F" standard date and time format specifier. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques, plus loin dans cette rubrique.For more information about using a single format specifier, see Using Single Custom Format Specifiers later in this topic.

Le nombre de spécificateurs de format "F" utilisés avec la méthode ParseExact, TryParseExact, ParseExact ou TryParseExact indique le nombre maximum possible des chiffres les plus significatifs de la fraction de seconde pour analyser correctement la chaîne.The number of "F" format specifiers used with the ParseExact, TryParseExact, ParseExact, or TryParseExact method indicates the maximum number of most significant digits of the seconds fraction that can be present to successfully parse the string.

L'exemple suivant inclut le spécificateur de format personnalisé "F" dans une chaîne de format personnalisée.The following example includes the "F" custom format specifier in a custom format string.

DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;

Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture

Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018

Retour au tableauBack to table

Spécificateur de format personnalisé "FF"The "FF" custom format specifier

Le spécificateur de format personnalisé "FF" représente les deux chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les centièmes de seconde dans une valeur de date et d'heure.The "FF" custom format specifier represents the two most significant digits of the seconds fraction; that is, it represents the hundredths of a second in a date and time value. Toutefois, les zéros de fin ou deux chiffres zéro ne sont pas affichés.However, trailing zeros or two zero digits are not displayed.

L'exemple suivant inclut le spécificateur de format personnalisé "FF" dans une chaîne de format personnalisée.The following example includes the "FF" custom format specifier in a custom format string.

DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;

Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture

Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018

Retour au tableauBack to table

Spécificateur de format personnalisé "FFF"The "FFF" custom format specifier

Le spécificateur de format personnalisé "FFF" représente les trois chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les millisecondes dans une valeur de date et d'heure.The "FFF" custom format specifier represents the three most significant digits of the seconds fraction; that is, it represents the milliseconds in a date and time value. Toutefois, les zéros de fin ou trois chiffres zéro ne sont pas affichés.However, trailing zeros or three zero digits are not displayed.

L'exemple suivant inclut le spécificateur de format personnalisé "FFF" dans une chaîne de format personnalisée.The following example includes the "FFF" custom format specifier in a custom format string.

DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;

Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture

Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018

Retour au tableauBack to table

Spécificateur de format personnalisé "FFFF"The "FFFF" custom format specifier

Le spécificateur de format personnalisé "FFFF" représente les quatre chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les dix millièmes de seconde dans une valeur de date et d'heure.The "FFFF" custom format specifier represents the four most significant digits of the seconds fraction; that is, it represents the ten thousandths of a second in a date and time value. Toutefois, les zéros de fin ou quatre chiffres zéro ne sont pas affichés.However, trailing zeros or four zero digits are not displayed.

Bien qu'il soit possible d'afficher les dix millièmes du composant "secondes" d'une valeur d'heure, cette valeur peut ne pas être significative.Although it is possible to display the ten thousandths of a second component of a time value, that value may not be meaningful. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système.The precision of date and time values depends on the resolution of the system clock. Sur les systèmes d’exploitation Windows NT 3.5 (et versions ultérieures) et Windows Vista, la résolution de l’horloge est d’environ 10-15 millisecondes.On the Windows NT 3.5 (and later) and Windows Vista operating systems, the clock's resolution is approximately 10-15 milliseconds.

Retour au tableauBack to table

Spécificateur de format personnalisé "FFFFF"The "FFFFF" custom format specifier

Le spécificateur de format personnalisé "FFFFF" représente les cinq chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les cent millièmes de seconde dans une valeur de date et d'heure.The "FFFFF" custom format specifier represents the five most significant digits of the seconds fraction; that is, it represents the hundred thousandths of a second in a date and time value. Toutefois, les zéros de fin ou cinq chiffres zéro ne sont pas affichés.However, trailing zeros or five zero digits are not displayed.

Bien qu'il soit possible d'afficher les cent millièmes du composant "secondes" d'une valeur d'heure, cette valeur peut ne pas être significative.Although it is possible to display the hundred thousandths of a second component of a time value, that value may not be meaningful. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système.The precision of date and time values depends on the resolution of the system clock. Sur les systèmes d’exploitation Windows NT 3.5 (et versions ultérieures) et Windows Vista, la résolution de l’horloge est d’environ 10-15 millisecondes.On the Windows NT 3.5 (and later) and Windows Vista operating systems, the clock's resolution is approximately 10-15 milliseconds.

Retour au tableauBack to table

Spécificateur de format personnalisé "FFFFFF"The "FFFFFF" custom format specifier

Le spécificateur de format personnalisé "FFFFFF" représente les six chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les millionièmes de seconde dans une valeur de date et d'heure.The "FFFFFF" custom format specifier represents the six most significant digits of the seconds fraction; that is, it represents the millionths of a second in a date and time value. Toutefois, les zéros de fin ou six chiffres zéro ne sont pas affichés.However, trailing zeros or six zero digits are not displayed.

Bien qu'il soit possible d'afficher les millionièmes du composant "secondes" d'une valeur d'heure, cette valeur peut ne pas être significative.Although it is possible to display the millionths of a second component of a time value, that value may not be meaningful. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système.The precision of date and time values depends on the resolution of the system clock. Sur les systèmes d’exploitation Windows NT 3.5 (et versions ultérieures) et Windows Vista, la résolution de l’horloge est d’environ 10-15 millisecondes.On tfhe Windows NT 3.5 (and later) and Windows Vista operating systems, the clock's resolution is approximately 10-15 milliseconds.

Retour au tableauBack to table

Spécificateur de format personnalisé "FFFFFFF"The "FFFFFFF" custom format specifier

Le spécificateur de format personnalisé "FFFFFFF" représente les sept chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les dix millionièmes de seconde dans une valeur de date et d'heure.The "FFFFFFF" custom format specifier represents the seven most significant digits of the seconds fraction; that is, it represents the ten millionths of a second in a date and time value. Toutefois, les zéros de fin ou sept chiffres zéro ne sont pas affichés.However, trailing zeros or seven zero digits are not displayed.

Bien qu'il soit possible d'afficher les dix millionièmes du composant "secondes" d'une valeur d'heure, cette valeur peut ne pas être significative.Although it is possible to display the ten millionths of a second component of a time value, that value may not be meaningful. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système.The precision of date and time values depends on the resolution of the system clock. Sur les systèmes d’exploitation Windows NT 3.5 (et versions ultérieures) et Windows Vista, la résolution de l’horloge est d’environ 10-15 millisecondes.On the Windows NT 3.5 (and later) and Windows Vista operating systems, the clock's resolution is approximately 10-15 milliseconds.

Retour au tableauBack to table

Spécificateur de format personnalisé "g" ou "gg"The "g" or "gg" custom format specifier

Les spécificateurs de format personnalisés "g" ou "gg" (plus n'importe quel nombre de spécificateurs "g" supplémentaires) représentent la période ou l'ère, par exemple après J.-C.The "g" or "gg" custom format specifiers (plus any number of additional "g" specifiers) represents the period or era, such as A.D. L'opération de mise en forme ignore ce spécificateur si la date à mettre en forme n'est associée à aucune chaîne de période ou d'ère.The formatting operation ignores this specifier if the date to be formatted does not have an associated period or era string.

Si le spécificateur de format "g" est utilisé sans autre spécificateur de format personnalisé, il est interprété comme le spécificateur de format de date et d'heure standard "g".If the "g" format specifier is used without other custom format specifiers, it is interpreted as the "g" standard date and time format specifier. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques, plus loin dans cette rubrique.For more information about using a single format specifier, see Using Single Custom Format Specifiers later in this topic.

L'exemple suivant inclut le spécificateur de format personnalisé "g" dans une chaîne de format personnalisée.The following example includes the "g" custom format specifier in a custom format string.

DateTime date1 = new DateTime(70, 08, 04);

Console.WriteLine(date1.ToString("MM/dd/yyyy g", 
                  CultureInfo.InvariantCulture));
// Displays 08/04/0070 A.D.                        
Console.WriteLine(date1.ToString("MM/dd/yyyy g", 
                  CultureInfo.CreateSpecificCulture("fr-FR")));                         
// Displays 08/04/0070 ap. J.-C.
Dim date1 As Date = #08/04/0070#

Console.WriteLine(date1.ToString("MM/dd/yyyy g", _
                  CultureInfo.InvariantCulture))
' Displays 08/04/0070 A.D.                        
Console.WriteLine(date1.ToString("MM/dd/yyyy g", _
                  CultureInfo.CreateSpecificCulture("fr-FR")))                         
' Displays 08/04/0070 ap. J.-C.

Retour au tableauBack to table

Spécificateur de format personnalisé "h"The "h" custom format specifier

Le spécificateur de format personnalisé "h" représente l'heure sous la forme d'un nombre compris entre 1 et 12 ; autrement dit, l'heure est représentée au format de 12 heures qui compte les heures entières depuis minuit ou midi.The "h" custom format specifier represents the hour as a number from 1 through 12; that is, the hour is represented by a 12-hour clock that counts the whole hours since midnight or noon. Une heure après minuit se présente de la même manière que la même heure après midi.A particular hour after midnight is indistinguishable from the same hour after noon. L'heure n'est pas arrondie et une heure à un seul chiffre est mise en forme sans zéro non significatif.The hour is not rounded, and a single-digit hour is formatted without a leading zero. Par exemple, si on considère l'heure 5:43 du matin ou de l'après-midi, ce spécificateur de format personnalisé affiche "5".For example, given a time of 5:43 in the morning or afternoon, this custom format specifier displays "5".

Si le spécificateur de format "h" est utilisé sans autre spécificateur de format personnalisé, il est interprété comme un spécificateur de format de date et d'heure standard et lève un FormatException.If the "h" format specifier is used without other custom format specifiers, it is interpreted as a standard date and time format specifier and throws a FormatException. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques, plus loin dans cette rubrique.For more information about using a single format specifier, see Using Single Custom Format Specifiers later in this topic.

L'exemple suivant inclut le spécificateur de format personnalisé "h" dans une chaîne de format personnalisée.The following example includes the "h" custom format specifier in a custom format string.

DateTime date1; 
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1 µ                        
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5 µ
Dim date1 As Date 
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1 µ                        
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5 µ

Retour au tableauBack to table

Spécificateur de format personnalisé "hh"The "hh" custom format specifier

Le spécificateur de format personnalisé "hh" (plus n'importe quel nombre de spécificateurs "h" supplémentaires) représente l'heure sous la forme d'un nombre compris entre 01 et 12 ; autrement dit, l'heure est représentée au format de 12 heures qui compte les heures entières depuis minuit ou midi.The "hh" custom format specifier (plus any number of additional "h" specifiers) represents the hour as a number from 01 through 12; that is, the hour is represented by a 12-hour clock that counts the whole hours since midnight or noon. Une heure après minuit se présente de la même manière que la même heure après midi.A particular hour after midnight is indistinguishable from the same hour after noon. L'heure n'est pas arrondie et une heure à un seul chiffre est mise en forme avec un zéro non significatif.The hour is not rounded, and a single-digit hour is formatted with a leading zero. Par exemple, si on considère l'heure 5:43 du matin ou de l'après-midi, ce spécificateur de format affiche "05".For example, given a time of 5:43 in the morning or afternoon, this format specifier displays "05".

L'exemple suivant inclut le spécificateur de format personnalisé "hh" dans une chaîne de format personnalisée.The following example includes the "hh" custom format specifier in a custom format string.

DateTime date1; 
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss tt", 
                  CultureInfo.InvariantCulture));
// Displays 06:09:01 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss tt", 
                  CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", 
                  CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", 
                  CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
Dim date1 As Date 
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
                  CultureInfo.InvariantCulture))
' Displays 06:09:01 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
                  CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
                  CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
                  CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.

Retour au tableauBack to table

Spécificateur de format personnalisé "H"The "H" custom format specifier

Le spécificateur de format personnalisé "H" représente l'heure sous la forme d'un nombre compris entre 0 et 23 ; autrement dit, l'heure est représentée au format de 24 heures de base zéro qui compte les heures depuis minuit.The "H" custom format specifier represents the hour as a number from 0 through 23; that is, the hour is represented by a zero-based 24-hour clock that counts the hours since midnight. Une heure à un seul chiffre est mise en forme sans zéro non significatif.A single-digit hour is formatted without a leading zero.

Si le spécificateur de format "H" est utilisé sans autre spécificateur de format personnalisé, il est interprété comme un spécificateur de format de date et d'heure standard et lève un FormatException.If the "H" format specifier is used without other custom format specifiers, it is interpreted as a standard date and time format specifier and throws a FormatException. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques, plus loin dans cette rubrique.For more information about using a single format specifier, see Using Single Custom Format Specifiers later in this topic.

L'exemple suivant inclut le spécificateur de format personnalisé "H" dans une chaîne de format personnalisée.The following example includes the "H" custom format specifier in a custom format string.

DateTime date1 = new DateTime(2008, 1, 1, 6, 9, 1);
Console.WriteLine(date1.ToString("H:mm:ss", 
                  CultureInfo.InvariantCulture));
// Displays 6:09:01              
Dim date1 As Date = #6:09:01AM#
Console.WriteLine(date1.ToString("H:mm:ss", _
                  CultureInfo.InvariantCulture))
' Displays 6:09:01                        

Retour au tableauBack to table

Spécificateur de format personnalisé "HH"The "HH" custom format specifier

Le spécificateur de format personnalisé "HH" (plus n'importe quel nombre de spécificateurs "H" supplémentaires) représente l'heure sous la forme d'un nombre compris entre 00 et 23 ; autrement dit, l'heure est représentée au format de 24 heures de base zéro qui compte les heures depuis minuit.The "HH" custom format specifier (plus any number of additional "H" specifiers) represents the hour as a number from 00 through 23; that is, the hour is represented by a zero-based 24-hour clock that counts the hours since midnight. Une heure à un seul chiffre est mise en forme avec un zéro non significatif.A single-digit hour is formatted with a leading zero.

L'exemple suivant inclut le spécificateur de format personnalisé "HH" dans une chaîne de format personnalisée.The following example includes the "HH" custom format specifier in a custom format string.

DateTime date1 = new DateTime(2008, 1, 1, 6, 9, 1);
Console.WriteLine(date1.ToString("HH:mm:ss", 
                  CultureInfo.InvariantCulture));
// Displays 06:09:01                        
Dim date1 As Date = #6:09:01AM#
Console.WriteLine(date1.ToString("HH:mm:ss", _
                  CultureInfo.InvariantCulture))
' Displays 06:09:01                        

Retour au tableauBack to table

Spécificateur de format personnalisé "K"The "K" custom format specifier

Le spécificateur de format personnalisé "K" représente les informations de fuseau horaire d'une valeur de date et d'heure.The "K" custom format specifier represents the time zone information of a date and time value. Lorsque ce spécificateur de format est utilisé avec les valeurs DateTime, la chaîne de résultat est définie par la valeur de la propriété DateTime.Kind :When this format specifier is used with DateTime values, the result string is defined by the value of the DateTime.Kind property:

  • Pour le fuseau horaire local (une valeur de propriété DateTime.Kind de DateTimeKind.Local), ce spécificateur est équivalent au spécificateur "zzz" et produit une chaîne de résultat contenant l'offset local par rapport au temps universel coordonné (UTC, Universal Time Coordinated) ; par exemple, "-07:00".For the local time zone (a DateTime.Kind property value of DateTimeKind.Local), this specifier is equivalent to the "zzz" specifier and produces a result string containing the local offset from Coordinated Universal Time (UTC); for example, "-07:00".

  • Pour une heure UTC (une valeur de propriété DateTime.Kind de DateTimeKind.Utc), la chaîne de résultat inclut un caractère "Z" pour représenter une date UTC.For a UTC time (a DateTime.Kind property value of DateTimeKind.Utc), the result string includes a "Z" character to represent a UTC date.

  • Pour une heure d'un fuseau horaire non spécifié (une heure dont la propriété DateTime.Kind a la valeur DateTimeKind.Unspecified), le résultat est équivalent à String.Empty.For a time from an unspecified time zone (a time whose DateTime.Kind property equals DateTimeKind.Unspecified), the result is equivalent to String.Empty.

Pour les valeurs DateTimeOffset, le spécificateur de format "K" est équivalent au spécificateur de format "zzz", et produit une chaîne de résultat contenant l'offset de la valeur DateTimeOffset par rapport à l'heure UTC.For DateTimeOffset values, the "K" format specifier is equivalent to the "zzz" format specifier, and produces a result string containing the DateTimeOffset value's offset from UTC.

Si le spécificateur de format "K" est utilisé sans autre spécificateur de format personnalisé, il est interprété comme un spécificateur de format de date et d'heure standard et lève un FormatException.If the "K" format specifier is used without other custom format specifiers, it is interpreted as a standard date and time format specifier and throws a FormatException. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques, plus loin dans cette rubrique.For more information about using a single format specifier, see Using Single Custom Format Specifiers later in this topic.

L'exemple suivant affiche la chaîne qui résulte de l'utilisation du spécificateur de format personnalisé "K" avec différentes valeurs DateTime et DateTimeOffset sur un système situé dans le fuseau horaire Pacifique (États-Unis).The following example displays the string that results from using the "K" custom format specifier with various DateTime and DateTimeOffset values on a system in the U.S. Pacific Time zone.

Console.WriteLine(DateTime.Now.ToString("%K"));
// Displays -07:00
Console.WriteLine(DateTime.UtcNow.ToString("%K"));
// Displays Z      
Console.WriteLine("'{0}'", 
                  DateTime.SpecifyKind(DateTime.Now, 
                       DateTimeKind.Unspecified).ToString("%K"));
// Displays ''      
Console.WriteLine(DateTimeOffset.Now.ToString("%K"));
// Displays -07:00
Console.WriteLine(DateTimeOffset.UtcNow.ToString("%K"));
// Displays +00:00
Console.WriteLine(new DateTimeOffset(2008, 5, 1, 6, 30, 0, 
                      new TimeSpan(5, 0, 0)).ToString("%K"));
// Displays +05:00                        
Console.WriteLine(Date.Now.ToString("%K"))
' Displays -07:00
Console.WriteLine(Date.UtcNow.ToString("%K"))
' Displays Z      
Console.WriteLine("'{0}'", _
                  Date.SpecifyKind(Date.Now, _
                                   DateTimeKind.Unspecified). _
                  ToString("%K"))
' Displays ''      
Console.WriteLine(DateTimeOffset.Now.ToString("%K"))
' Displays -07:00
Console.WriteLine(DateTimeOffset.UtcNow.ToString("%K"))
' Displays +00:00
Console.WriteLine(New DateTimeOffset(2008, 5, 1, 6, 30, 0, _
                                     New TimeSpan(5, 0, 0)). _
                  ToString("%K"))
' Displays +05:00                        

Retour au tableauBack to table

Spécificateur de format personnalisé "m"The "m" custom format specifier

Le spécificateur de format personnalisé "m" représente la minute sous la forme d'un nombre compris entre 0 et 59.The "m" custom format specifier represents the minute as a number from 0 through 59. La minute représente les minutes entières qui se sont écoulées depuis la dernière heure.The minute represents whole minutes that have passed since the last hour. Une minute à un seul chiffre est mise en forme sans zéro non significatif.A single-digit minute is formatted without a leading zero.

Si le spécificateur de format "m" est utilisé sans autre spécificateur de format personnalisé, il est interprété comme le spécificateur de format de date et d'heure standard "m".If the "m" format specifier is used without other custom format specifiers, it is interpreted as the "m" standard date and time format specifier. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques, plus loin dans cette rubrique.For more information about using a single format specifier, see Using Single Custom Format Specifiers later in this topic.

L'exemple suivant inclut le spécificateur de format personnalisé "m" dans une chaîne de format personnalisée.The following example includes the "m" custom format specifier in a custom format string.

DateTime date1; 
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1 µ                        
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5 µ
Dim date1 As Date 
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1 µ                        
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5 µ

Retour au tableauBack to table

Spécificateur de format personnalisé "mm"The "mm" custom format specifier

Le spécificateur de format personnalisé "mm" (plus n'importe quel nombre de spécificateurs "m" supplémentaires) représente la minute sous la forme d'un nombre compris entre 00 et 59.The "mm" custom format specifier (plus any number of additional "m" specifiers) represents the minute as a number from 00 through 59. La minute représente les minutes entières qui se sont écoulées depuis la dernière heure.The minute represents whole minutes that have passed since the last hour. Une minute à un seul chiffre est mise en forme avec un zéro non significatif.A single-digit minute is formatted with a leading zero.

L'exemple suivant inclut le spécificateur de format personnalisé "mm" dans une chaîne de format personnalisée.The following example includes the "mm" custom format specifier in a custom format string.

DateTime date1; 
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss tt", 
                  CultureInfo.InvariantCulture));
// Displays 06:09:01 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss tt", 
                  CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", 
                  CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", 
                  CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
Dim date1 As Date 
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
                  CultureInfo.InvariantCulture))
' Displays 06:09:01 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
                  CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
                  CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
                  CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.

Retour au tableauBack to table

Spécificateur de format personnalisé "M"The "M" custom format specifier

Le spécificateur de format personnalisé "M" représente le mois comme un nombre compris entre 1 et 12 (ou entre 1 et 13 pour les calendriers de 13 mois).The "M" custom format specifier represents the month as a number from 1 through 12 (or from 1 through 13 for calendars that have 13 months). Un mois à un seul chiffre est mis en forme sans zéro non significatif.A single-digit month is formatted without a leading zero.

Si le spécificateur de format "M" est utilisé sans autre spécificateur de format personnalisé, il est interprété comme le spécificateur de format de date et d'heure standard "M".If the "M" format specifier is used without other custom format specifiers, it is interpreted as the "M" standard date and time format specifier. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques, plus loin dans cette rubrique.For more information about using a single format specifier, see Using Single Custom Format Specifiers later in this topic.

L'exemple suivant inclut le spécificateur de format personnalisé "M" dans une chaîne de format personnalisée.The following example includes the "M" custom format specifier in a custom format string.

DateTime date1 = new DateTime(2008, 8, 18);
Console.WriteLine(date1.ToString("(M) MMM, MMMM", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays (8) Aug, August
Console.WriteLine(date1.ToString("(M) MMM, MMMM", 
                  CultureInfo.CreateSpecificCulture("nl-NL")));                       
// Displays (8) aug, augustus
Console.WriteLine(date1.ToString("(M) MMM, MMMM", 
                  CultureInfo.CreateSpecificCulture("lv-LV")));                        
// Displays (8) Aug, augusts                       
Dim date1 As Date = #8/18/2008#
Console.WriteLine(date1.ToString("(M) MMM, MMMM", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays (8) Aug, August
Console.WriteLine(date1.ToString("(M) MMM, MMMM", _
                  CultureInfo.CreateSpecificCulture("nl-NL")))                        
' Displays (8) aug, augustus
Console.WriteLine(date1.ToString("(M) MMM, MMMM", _
                  CultureInfo.CreateSpecificCulture("lv-LV")))                        
' Displays (8) Aug, augusts                       

Retour au tableauBack to table

Spécificateur de format personnalisé "MM"The "MM" custom format specifier

Le spécificateur de format personnalisé "MM" représente le mois comme un nombre compris entre 01 et 12 (ou entre 01 et 13 pour les calendriers de 13 mois).The "MM" custom format specifier represents the month as a number from 01 through 12 (or from 1 through 13 for calendars that have 13 months). Un mois à un seul chiffre est mis en forme avec un zéro non significatif.A single-digit month is formatted with a leading zero.

L'exemple suivant inclut le spécificateur de format personnalisé "MM" dans une chaîne de format personnalisée.The following example includes the "MM" custom format specifier in a custom format string.

DateTime date1 = new DateTime(2008, 1, 2, 6, 30, 15);

Console.WriteLine(date1.ToString("dd, MM", 
                  CultureInfo.InvariantCulture)); 
// 02, 01
Dim date1 As Date = #1/2/2008 6:30:15AM#

Console.WriteLine(date1.ToString("dd, MM", _
                  CultureInfo.InvariantCulture)) 
' 02, 01

Retour au tableauBack to table

Spécificateur de format personnalisé "MMM"The "MMM" custom format specifier

Le spécificateur de format personnalisé "MMM" représente le nom abrégé du mois.The "MMM" custom format specifier represents the abbreviated name of the month. Le nom abrégé localisé du mois est récupéré de la propriété DateTimeFormatInfo.AbbreviatedMonthNames de la culture actuelle ou spécifiée.The localized abbreviated name of the month is retrieved from the DateTimeFormatInfo.AbbreviatedMonthNames property of the current or specified culture.

L'exemple suivant inclut le spécificateur de format personnalisé "MMM" dans une chaîne de format personnalisée.The following example includes the "MMM" custom format specifier in a custom format string.

DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);

Console.WriteLine(date1.ToString("ddd d MMM", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM", 
                  CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays ven. 29 août                                                
Dim date1 As Date = #08/29/2008 7:27:15PM#

Console.WriteLine(date1.ToString("ddd d MMM", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM", _
                  CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays ven. 29 août                                                

Retour au tableauBack to table

Spécificateur de format personnalisé "MMMM"The "MMMM" custom format specifier

Le spécificateur de format personnalisé "MMMM" représente le nom complet du mois.The "MMMM" custom format specifier represents the full name of the month. Le nom localisé du mois est récupéré de la propriété DateTimeFormatInfo.MonthNames de la culture actuelle ou spécifiée.The localized name of the month is retrieved from the DateTimeFormatInfo.MonthNames property of the current or specified culture.

L'exemple suivant inclut le spécificateur de format personnalisé "MMMM" dans une chaîne de format personnalisée.The following example includes the "MMMM" custom format specifier in a custom format string.

DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);

Console.WriteLine(date1.ToString("dddd dd MMMM", 
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM", 
                  CultureInfo.CreateSpecificCulture("it-IT")));
// Displays venerdì 29 agosto                                
Dim date1 As Date = #08/29/2008 7:27:15PM#

Console.WriteLine(date1.ToString("dddd dd MMMM", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM", _
                  CultureInfo.CreateSpecificCulture("it-IT")))
' Displays venerdì 29 agosto                                          

Retour au tableauBack to table

Spécificateur de format personnalisé "s"The "s" custom format specifier

Le spécificateur de format personnalisé "s" représente les secondes sous la forme d'un nombre compris entre 0 et 59.The "s" custom format specifier represents the seconds as a number from 0 through 59. Le résultat représente les secondes entières qui se sont écoulées depuis la dernière minute.The result represents whole seconds that have passed since the last minute. Une seconde à un seul chiffre est mise en forme sans zéro non significatif.A single-digit second is formatted without a leading zero.

Si le spécificateur de format "s" est utilisé sans autre spécificateur de format personnalisé, il est interprété comme le spécificateur de format de date et d'heure standard "s".If the "s" format specifier is used without other custom format specifiers, it is interpreted as the "s" standard date and time format specifier. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques, plus loin dans cette rubrique.For more information about using a single format specifier, see Using Single Custom Format Specifiers later in this topic.

L'exemple suivant inclut le spécificateur de format personnalisé "s" dans une chaîne de format personnalisée.The following example includes the "s" custom format specifier in a custom format string.

DateTime date1; 
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1 µ                        
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5 µ
Dim date1 As Date 
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1 µ                        
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5 µ

Retour au tableauBack to table

Spécificateur de format personnalisé "ss"The "ss" custom format specifier

Le spécificateur de format personnalisé "ss" (plus n'importe quel nombre de spécificateurs "s" supplémentaires) représente les secondes sous la forme d'un nombre compris entre 00 et 59.The "ss" custom format specifier (plus any number of additional "s" specifiers) represents the seconds as a number from 00 through 59. Le résultat représente les secondes entières qui se sont écoulées depuis la dernière minute.The result represents whole seconds that have passed since the last minute. Une seconde à un seul chiffre est mise en forme avec un zéro non significatif.A single-digit second is formatted with a leading zero.

L'exemple suivant inclut le spécificateur de format personnalisé "ss" dans une chaîne de format personnalisée.The following example includes the "ss" custom format specifier in a custom format string.

DateTime date1; 
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss tt", 
                  CultureInfo.InvariantCulture));
// Displays 06:09:01 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss tt", 
                  CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", 
                  CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", 
                  CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
Dim date1 As Date 
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
                  CultureInfo.InvariantCulture))
' Displays 06:09:01 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
                  CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
                  CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
                  CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.

Retour au tableauBack to table

Spécificateur de format personnalisé "t"The "t" custom format specifier

Le spécificateur de format personnalisé "t" représente le premier caractère de l'indicateur AM/PM.The "t" custom format specifier represents the first character of the AM/PM designator. L'indicateur localisé approprié est récupéré de la propriété DateTimeFormatInfo.AMDesignator ou DateTimeFormatInfo.PMDesignator de la culture actuelle ou spécifique.The appropriate localized designator is retrieved from the DateTimeFormatInfo.AMDesignator or DateTimeFormatInfo.PMDesignator property of the current or specific culture. L'indicateur AM est utilisé pour toutes les heures comprises entre 0:00:00 (minuit) et 11:59:59.999.The AM designator is used for all times from 0:00:00 (midnight) to 11:59:59.999. L'indicateur PM est utilisé pour toutes les heures comprises entre 12:00:00 (midi) et 23:59:59.999.The PM designator is used for all times from 12:00:00 (noon) to 23:59:59.999.

Si le spécificateur de format "t" est utilisé sans autre spécificateur de format personnalisé, il est interprété comme le spécificateur de format de date et d'heure standard "t".If the "t" format specifier is used without other custom format specifiers, it is interpreted as the "t" standard date and time format specifier. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques, plus loin dans cette rubrique.For more information about using a single format specifier, see Using Single Custom Format Specifiers later in this topic.

L'exemple suivant inclut le spécificateur de format personnalisé "t" dans une chaîne de format personnalisée.The following example includes the "t" custom format specifier in a custom format string.

DateTime date1; 
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1 µ                        
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", 
                  CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5 µ
Dim date1 As Date 
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1 µ                        
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
                  CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5 µ

Retour au tableauBack to table

Spécificateur de format personnalisé "tt"The "tt" custom format specifier

Le spécificateur de format personnalisé "tt" (plus n'importe quel nombre de spécificateurs "t" supplémentaires) représente l'intégralité de l'indicateur AM/PM.The "tt" custom format specifier (plus any number of additional "t" specifiers) represents the entire AM/PM designator. L'indicateur localisé approprié est récupéré de la propriété DateTimeFormatInfo.AMDesignator ou DateTimeFormatInfo.PMDesignator de la culture actuelle ou spécifique.The appropriate localized designator is retrieved from the DateTimeFormatInfo.AMDesignator or DateTimeFormatInfo.PMDesignator property of the current or specific culture. L'indicateur AM est utilisé pour toutes les heures comprises entre 0:00:00 (minuit) et 11:59:59.999.The AM designator is used for all times from 0:00:00 (midnight) to 11:59:59.999. L'indicateur PM est utilisé pour toutes les heures comprises entre 12:00:00 (midi) et 23:59:59.999.The PM designator is used for all times from 12:00:00 (noon) to 23:59:59.999.

Veillez à utiliser le spécificateur "tt" pour les langues pour lesquelles il est nécessaire de maintenir la distinction entre AM et PM.Make sure to use the "tt" specifier for languages for which it is necessary to maintain the distinction between AM and PM. Un exemple est illustré par la langue japonaise, pour laquelle les indicateurs AM/PM se distinguent dans le deuxième caractère au lieu du premier.An example is Japanese, for which the AM and PM designators differ in the second character instead of the first character.

L'exemple suivant inclut le spécificateur de format personnalisé "tt" dans une chaîne de format personnalisée.The following example includes the "tt" custom format specifier in a custom format string.

DateTime date1; 
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss tt", 
                  CultureInfo.InvariantCulture));
// Displays 06:09:01 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss tt", 
                  CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", 
                  CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", 
                  CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
Dim date1 As Date 
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
                  CultureInfo.InvariantCulture))
' Displays 06:09:01 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
                  CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
                  CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM                        
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
                  CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.

Retour au tableauBack to table

Spécificateur de format personnalisé "y"The "y" custom format specifier

Le spécificateur de format personnalisé "y" représente l'année sous la forme d'un nombre à un chiffre ou à deux chiffres.The "y" custom format specifier represents the year as a one-digit or two-digit number. Si l'année comporte plus de deux chiffres, seuls les deux chiffres de poids faible apparaissent dans le résultat.If the year has more than two digits, only the two low-order digits appear in the result. Si le premier chiffre d'une année sur deux chiffres commence par un zéro (par exemple, 2008), le nombre est mis en forme sans zéro non significatif.If the first digit of a two-digit year begins with a zero (for example, 2008), the number is formatted without a leading zero.

Si le spécificateur de format "y" est utilisé sans autre spécificateur de format personnalisé, il est interprété comme le spécificateur de format de date et d'heure standard "y".If the "y" format specifier is used without other custom format specifiers, it is interpreted as the "y" standard date and time format specifier. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques, plus loin dans cette rubrique.For more information about using a single format specifier, see Using Single Custom Format Specifiers later in this topic.

L'exemple suivant inclut le spécificateur de format personnalisé "y" dans une chaîne de format personnalisée.The following example includes the "y" custom format specifier in a custom format string.

DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010      
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010      
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010      
Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010      
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010      
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010      

Retour au tableauBack to table

Spécificateur de format personnalisé "yy"The "yy" custom format specifier

Le spécificateur de format personnalisé "yy" représente l'année sous la forme d'un nombre à deux chiffres.The "yy" custom format specifier represents the year as a two-digit number. Si l'année comporte plus de deux chiffres, seuls les deux chiffres de poids faible apparaissent dans le résultat.If the year has more than two digits, only the two low-order digits appear in the result. Si l'année à deux chiffres comporte moins de deux chiffres significatifs, le nombre est complété avec des zéros non significatifs pour qu'il possède deux chiffres.If the two-digit year has fewer than two significant digits, the number is padded with leading zeros to produce two digits.

Dans une opération d'analyse, une année à deux chiffres qui est analysée avec le spécificateur de format personnalisé "yy" est interprétée sur la base de la propriété Calendar.TwoDigitYearMax du calendrier actuel du fournisseur de format.In a parsing operation, a two-digit year that is parsed using the "yy" custom format specifier is interpreted based on the Calendar.TwoDigitYearMax property of the format provider's current calendar. L'exemple suivant analyse la représentation sous forme de chaîne d'une date ayant une année à deux chiffres, en utilisant le calendrier grégorien par défaut de la culture en-US, laquelle représente la culture actuelle.The following example parses the string representation of a date that has a two-digit year by using the default Gregorian calendar of the en-US culture, which, in this case, is the current culture. Il remplace ensuite l'objet CultureInfo de la culture actuelle afin d'utiliser un objet GregorianCalendar dont la propriété TwoDigitYearMax a été modifiée.It then changes the current culture's CultureInfo object to use a GregorianCalendar object whose TwoDigitYearMax property has been modified.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      string fmt = "dd-MMM-yy";
      string value = "24-Jan-49";
      
      Calendar cal = (Calendar) CultureInfo.CurrentCulture.Calendar.Clone();
      Console.WriteLine("Two Digit Year Range: {0} - {1}", 
                        cal.TwoDigitYearMax - 99, cal.TwoDigitYearMax);
      
      Console.WriteLine("{0:d}", DateTime.ParseExact(value, fmt, null));
      Console.WriteLine();
      
      cal.TwoDigitYearMax = 2099;
      CultureInfo culture = (CultureInfo) CultureInfo.CurrentCulture.Clone();
      culture.DateTimeFormat.Calendar = cal;
      Thread.CurrentThread.CurrentCulture = culture;

      Console.WriteLine("Two Digit Year Range: {0} - {1}", 
                        cal.TwoDigitYearMax - 99, cal.TwoDigitYearMax);
      Console.WriteLine("{0:d}", DateTime.ParseExact(value, fmt, null));
   }
}
// The example displays the following output:
//       Two Digit Year Range: 1930 - 2029
//       1/24/1949
//       
//       Two Digit Year Range: 2000 - 2099
//       1/24/2049
Imports System.Globalization
Imports System.Threading

Module Example
   Public Sub Main()
      Dim fmt As String = "dd-MMM-yy"
      Dim value As String = "24-Jan-49"
      
      Dim cal As Calendar = CType(CultureInfo.CurrentCulture.Calendar.Clone(), Calendar)
      Console.WriteLine("Two Digit Year Range: {0} - {1}", 
                        cal.TwoDigitYearMax - 99, cal.TwoDigitYearMax)
      
      Console.WriteLine("{0:d}", DateTime.ParseExact(value, fmt, Nothing))
      Console.WriteLine()
      
      cal.TwoDigitYearMax = 2099
      Dim culture As CultureInfo = CType(CultureInfo.CurrentCulture.Clone(), CultureInfo)
      culture.DateTimeFormat.Calendar = cal
      Thread.CurrentThread.CurrentCulture = culture

      Console.WriteLine("Two Digit Year Range: {0} - {1}", 
                        cal.TwoDigitYearMax - 99, cal.TwoDigitYearMax)
      Console.WriteLine("{0:d}", DateTime.ParseExact(value, fmt, Nothing))
   End Sub
End Module
' The example displays the following output:
'       Two Digit Year Range: 1930 - 2029
'       1/24/1949
'       
'       Two Digit Year Range: 2000 - 2099
'       1/24/2049

L'exemple suivant inclut le spécificateur de format personnalisé "yy" dans une chaîne de format personnalisé.The following example includes the "yy" custom format specifier in a custom format string.

DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010      
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010      
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010      
Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010      
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010      
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010      

Retour au tableauBack to table

Spécificateur de format personnalisé "yyy"The "yyy" custom format specifier

Le spécificateur de format personnalisé "yyy" représente l'année avec un minimum de trois chiffres.The "yyy" custom format specifier represents the year with a minimum of three digits. Si l'année comporte plus de trois chiffres significatifs, ils sont inclus dans la chaîne résultante.If the year has more than three significant digits, they are included in the result string. Si l'année comporte moins de trois chiffres, le nombre est rempli avec des zéros non significatifs pour produire trois chiffres.If the year has fewer than three digits, the number is padded with leading zeros to produce three digits.

Note

Pour le calendrier bouddhiste thaïlandais, qui peut comporter des années à cinq chiffres, ce spécificateur de format affiche tous les chiffres significatifs.For the Thai Buddhist calendar, which can have five-digit years, this format specifier displays all significant digits.

L'exemple suivant inclut le spécificateur de format personnalisé "yyy" dans une chaîne de format personnalisée.The following example includes the "yyy" custom format specifier in a custom format string.

DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010      
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010      
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010      
Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010      
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010      
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010      

Retour au tableauBack to table

Spécificateur de format personnalisé "yyyy"The "yyyy" custom format specifier

Le spécificateur de format personnalisé "yyyy" représente l'année avec un minimum de quatre chiffres.The "yyyy" custom format specifier represents the year with a minimum of four digits. Si l'année comporte plus de quatre chiffres significatifs, ils sont inclus dans la chaîne résultante.If the year has more than four significant digits, they are included in the result string. Si l'année comporte moins de quatre chiffres, le nombre est rempli à l'aide de zéros non significatifs pour produire quatre chiffres.If the year has fewer than four digits, the number is padded with leading zeros to produce four digits.

Note

Pour le calendrier bouddhiste thaïlandais, qui peut comporter des années à cinq chiffres, ce spécificateur de format affiche au minimum quatre chiffres.For the Thai Buddhist calendar, which can have five-digit years, this format specifier displays a minimum of four digits.

L'exemple suivant inclut le spécificateur de format personnalisé "yyyy" dans une chaîne de format personnalisée.The following example includes the "yyyy" custom format specifier in a custom format string.

DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010      
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010      
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010      
Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010      
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010      
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010      

Retour au tableauBack to table

Spécificateur de format personnalisé "yyyyy"The "yyyyy" custom format specifier

Le spécificateur de format personnalisé "yyyyy" (plus tout nombre de spécificateurs "y" supplémentaires) représente l'année avec au minimum cinq chiffres.The "yyyyy" custom format specifier (plus any number of additional "y" specifiers) represents the year with a minimum of five digits. Si l'année comporte plus de cinq chiffres significatifs, ils sont inclus dans la chaîne résultante.If the year has more than five significant digits, they are included in the result string. Si l'année comporte moins de cinq chiffres, le nombre est rempli avec des zéros non significatifs pour produire cinq chiffres.If the year has fewer than five digits, the number is padded with leading zeros to produce five digits.

S'il existe des spécificateurs "y" supplémentaires, le nombre est rempli avec autant de zéros non significatifs que nécessaire pour produire le nombre de spécificateurs "y".If there are additional "y" specifiers, the number is padded with as many leading zeros as necessary to produce the number of "y" specifiers.

L'exemple suivant inclut le spécificateur de format personnalisé "yyyyy" dans une chaîne de format personnalisée.The following example includes the "yyyyy" custom format specifier in a custom format string.

DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010      
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010      
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010      
Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010      
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010      
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010      

Retour au tableauBack to table

Spécificateur de format personnalisé "z"The "z" custom format specifier

Avec les valeurs DateTime, le spécificateur de format personnalisé "z" représente l'offset signé du fuseau horaire du système d'exploitation local par rapport au temps universel coordonné (UTC, Coordinated Universal Time), mesuré en heures.With DateTime values, the "z" custom format specifier represents the signed offset of the local operating system's time zone from Coordinated Universal Time (UTC), measured in hours. Il ne reflète pas la valeur de la propriété DateTime.Kind d'une instance.It does not reflect the value of an instance's DateTime.Kind property. C'est pourquoi il n'est pas recommandé d'utiliser le spécificateur de format "z" avec les valeurs DateTime.For this reason, the "z" format specifier is not recommended for use with DateTime values.

Avec les valeurs DateTimeOffset, ce spécificateur de format représente l'offset de la valeur DateTimeOffset par rapport à l'heure UTC, en heures.With DateTimeOffset values, this format specifier represents the DateTimeOffset value's offset from UTC in hours.

L'offset est toujours affiché avec un signe de début.The offset is always displayed with a leading sign. Un signe plus (+) indique les heures avant l'heure UTC, et un signe moins (-) indique les heures après l'heure UTC.A plus sign (+) indicates hours ahead of UTC, and a minus sign (-) indicates hours behind UTC. Un offset à un seul chiffre est mis en forme sans zéro non significatif.A single-digit offset is formatted without a leading zero.

Si le spécificateur de format "z" est utilisé sans autre spécificateur de format personnalisé, il est interprété comme un spécificateur de format de date et d'heure standard et lève un FormatException.If the "z" format specifier is used without other custom format specifiers, it is interpreted as a standard date and time format specifier and throws a FormatException. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques, plus loin dans cette rubrique.For more information about using a single format specifier, see Using Single Custom Format Specifiers later in this topic.

L'exemple suivant inclut le spécificateur de format personnalisé "z" dans une chaîne de format personnalisée.The following example includes the "z" custom format specifier in a custom format string.

DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", 
                  date1));
// Displays -7, -07, -07:00                     

DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0, 
                                          new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", 
                  date2));
// Displays +6, +06, +06:00
Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
                  date1))
' Displays -7, -07, -07:00                     

Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
                                New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
                  date2))                                     
' Displays +6, +06, +06:00

Retour au tableauBack to table

Spécificateur de format personnalisé "zz"The "zz" custom format specifier

Avec les valeurs DateTime, le spécificateur de format personnalisé "zz" représente l'offset signé du fuseau horaire du système d'exploitation local par rapport à l'heure UTC, mesuré en heures.With DateTime values, the "zz" custom format specifier represents the signed offset of the local operating system's time zone from UTC, measured in hours. Il ne reflète pas la valeur de la propriété DateTime.Kind d'une instance.It does not reflect the value of an instance's DateTime.Kind property. C'est pourquoi il n'est pas recommandé d'utiliser le spécificateur de format "zz" avec les valeurs DateTime.For this reason, the "zz" format specifier is not recommended for use with DateTime values.

Avec les valeurs DateTimeOffset, ce spécificateur de format représente l'offset de la valeur DateTimeOffset par rapport à l'heure UTC, en heures.With DateTimeOffset values, this format specifier represents the DateTimeOffset value's offset from UTC in hours.

L'offset est toujours affiché avec un signe de début.The offset is always displayed with a leading sign. Un signe plus (+) indique les heures avant l'heure UTC, et un signe moins (-) indique les heures après l'heure UTC.A plus sign (+) indicates hours ahead of UTC, and a minus sign (-) indicates hours behind UTC. Un offset à un seul chiffre est mis en forme avec un zéro non significatif.A single-digit offset is formatted with a leading zero.

L'exemple suivant inclut le spécificateur de format personnalisé "zz" dans une chaîne de format personnalisée.The following example includes the "zz" custom format specifier in a custom format string.

DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", 
                  date1));
// Displays -7, -07, -07:00                     

DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0, 
                                          new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", 
                  date2));
// Displays +6, +06, +06:00
Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
                  date1))
' Displays -7, -07, -07:00                     

Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
                                New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
                  date2))                                     
' Displays +6, +06, +06:00

Retour au tableauBack to table

Spécificateur de format personnalisé "zzz"The "zzz" custom format specifier

Avec les valeurs DateTime, le spécificateur de format personnalisé "zzz" représente l'offset signé du fuseau horaire du système d'exploitation local par rapport à l'heure UTC, mesuré en heures et en minutes.With DateTime values, the "zzz" custom format specifier represents the signed offset of the local operating system's time zone from UTC, measured in hours and minutes. Il ne reflète pas la valeur de la propriété DateTime.Kind d'une instance.It does not reflect the value of an instance's DateTime.Kind property. C'est pourquoi il n'est pas recommandé d'utiliser le spécificateur de format "zzz" avec les valeurs DateTime.For this reason, the "zzz" format specifier is not recommended for use with DateTime values.

Avec les valeurs DateTimeOffset, ce spécificateur de format représente l'offset de la valeur DateTimeOffset par rapport à l'heure UTC, en heures et en minutes.With DateTimeOffset values, this format specifier represents the DateTimeOffset value's offset from UTC in hours and minutes.

L'offset est toujours affiché avec un signe de début.The offset is always displayed with a leading sign. Un signe plus (+) indique les heures avant l'heure UTC, et un signe moins (-) indique les heures après l'heure UTC.A plus sign (+) indicates hours ahead of UTC, and a minus sign (-) indicates hours behind UTC. Un offset à un seul chiffre est mis en forme avec un zéro non significatif.A single-digit offset is formatted with a leading zero.

L'exemple suivant inclut le spécificateur de format personnalisé "zzz" dans une chaîne de format personnalisée.The following example includes the "zzz" custom format specifier in a custom format string.

DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", 
                  date1));
// Displays -7, -07, -07:00                     

DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0, 
                                          new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", 
                  date2));
// Displays +6, +06, +06:00
Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
                  date1))
' Displays -7, -07, -07:00                     

Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
                                New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
                  date2))                                     
' Displays +6, +06, +06:00

Retour au tableauBack to table

Spécificateur de format personnalisé ":"The ":" custom format specifier

Le spécificateur de format personnalisé ":" représente le séparateur d'heure, lequel est utilisé pour différencier les heures, les minutes et les secondes.The ":" custom format specifier represents the time separator, which is used to differentiate hours, minutes, and seconds. Le séparateur d'heure localisé approprié est récupéré de la propriété DateTimeFormatInfo.TimeSeparator de la culture actuelle ou spécifiée.The appropriate localized time separator is retrieved from the DateTimeFormatInfo.TimeSeparator property of the current or specified culture.

Note

Pour modifier le séparateur horaire d'une chaîne de date et heure, spécifiez le caractère de séparation dans un délimiteur de chaîne littérale.To change the time separator for a particular date and time string, specify the separator character within a literal string delimiter. Par exemple, la chaîne de format personnalisée hh'_'dd'_'ss produit une chaîne de résultat dans laquelle "_" (trait de soulignement) est toujours utilisé comme séparateur horaire.For example, the custom format string hh'_'dd'_'ss produces a result string in which "_" (an underscore) is always used as the time separator. Pour modifier le séparateur horaire de toutes les dates d'une culture, modifiez la valeur de la propriété DateTimeFormatInfo.TimeSeparator de la culture actuelle, ou instanciez un objet DateTimeFormatInfo, affectez le caractère à sa propriété TimeSeparator, puis appelez une surcharge de la méthode de mise en forme qui inclut un paramètre IFormatProvider.To change the time separator for all dates for a culture, either change the value of the DateTimeFormatInfo.TimeSeparator property of the current culture, or instantiate a DateTimeFormatInfo object, assign the character to its TimeSeparator property, and call an overload of the formatting method that includes an IFormatProvider parameter.

Si le spécificateur de format ":" est utilisé sans autre spécificateur de format personnalisé, il est interprété comme un spécificateur de format de date et d'heure standard et lève un FormatException.If the ":" format specifier is used without other custom format specifiers, it is interpreted as a standard date and time format specifier and throws a FormatException. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques, plus loin dans cette rubrique.For more information about using a single format specifier, see Using Single Custom Format Specifiers later in this topic.

Retour au tableauBack to table

Spécificateur de format personnalisé "/"The "/" custom format specifier

Le spécificateur de format personnalisé "/" représente le séparateur de date, lequel est utilisé pour différencier les années, les mois et les jours.The "/" custom format specifier represents the date separator, which is used to differentiate years, months, and days. Le séparateur de date localisé approprié est récupéré de la propriété DateTimeFormatInfo.DateSeparator de la culture actuelle ou spécifiée.The appropriate localized date separator is retrieved from the DateTimeFormatInfo.DateSeparator property of the current or specified culture.

Note

Pour modifier le séparateur de date d'une chaîne de date et heure, spécifiez le caractère de séparation dans un délimiteur de chaîne littérale.To change the date separator for a particular date and time string, specify the separator character within a literal string delimiter. Par exemple, la chaîne de format personnalisée mm'/'dd'/'yyyy produit une chaîne de résultat dans laquelle "/" est toujours utilisé comme séparateur de date.For example, the custom format string mm'/'dd'/'yyyy produces a result string in which "/" is always used as the date separator. Pour modifier le séparateur de date de toutes les dates d'une culture, modifiez la valeur de la propriété DateTimeFormatInfo.DateSeparator de la culture actuelle, ou instanciez un objet DateTimeFormatInfo, affectez le caractère à sa propriété DateSeparator, puis appelez une surcharge de la méthode de mise en forme qui inclut un paramètre IFormatProvider.To change the date separator for all dates for a culture, either change the value of the DateTimeFormatInfo.DateSeparator property of the current culture, or instantiate a DateTimeFormatInfo object, assign the character to its DateSeparator property, and call an overload of the formatting method that includes an IFormatProvider parameter.

Si le spécificateur de format "/" est utilisé sans autre spécificateur de format personnalisé, il est interprété comme un spécificateur de format de date et d'heure standard et lève un FormatException.If the "/" format specifier is used without other custom format specifiers, it is interpreted as a standard date and time format specifier and throws a FormatException. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques, plus loin dans cette rubrique.For more information about using a single format specifier, see Using Single Custom Format Specifiers later in this topic.

Retour au tableauBack to table

Littéraux de caractèreCharacter literals

Les caractères suivants dans une chaîne de format de date et d’heure standard ou personnalisée sont réservés et sont toujours interprétés comme des caractères de mise en forme ou, dans le cas de ", ', / et \ comme des caractères spéciaux.The following characters in a custom date and time format string are reserved and are always interpreted as formatting characters or, in the case of ", ', /, and \, as special characters.

FF HH KK MM dd
ff gg hh mm ss
tt oy ez % ::
/ "" '' |

Tous les autres caractères sont toujours interprétés comme des caractères littéraux et, dans une opération de mise en forme, sont inclus inchangés dans la chaîne de résultat.All other characters are always interpreted as character literals and, in a formatting operation, are included in the result string unchanged. Dans une opération d’analyse, ils doivent correspondre exactement aux caractères présents dans la chaîne d’entrée. La comparaison respecte la casse.In a parsing operation, they must match the characters in the input string exactly; the comparison is case-sensitive.

L’exemple suivant inclut les caractères littéraux « PST » (pour Pacific Standard Time, heure normale du Pacifique) et « PDT » (pour Pacific Daylight Time, heure d’été du Pacifique) pour représenter le fuseau horaire local dans une chaîne de format.The following example includes the literal characters "PST" (for Pacific Standard Time) and "PDT" (for Pacific Daylight Time) to represent the local time zone in a format string. Notez que la chaîne est incluse dans la chaîne de résultat, et qu’une chaîne qui inclut la chaîne du fuseau horaire local est également analysée avec succès.Note that the string is included in the result string, and that a string that includes the local time zone string also parses successfully.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      String[] formats = { "dd MMM yyyy hh:mm tt PST", 
                           "dd MMM yyyy hh:mm tt PDT" };
      var dat = new DateTime(2016, 8, 18, 16, 50, 0);
      // Display the result string. 
      Console.WriteLine(dat.ToString(formats[1]));
      
      // Parse a string. 
      String value = "25 Dec 2016 12:00 pm PST";
      DateTime newDate;
      if (DateTime.TryParseExact(value, formats, null, 
                                 DateTimeStyles.None, out newDate)) 
         Console.WriteLine(newDate);
      else
         Console.WriteLine("Unable to parse '{0}'", value);
   }
}
// The example displays the following output:
//       18 Aug 2016 04:50 PM PDT
//       12/25/2016 12:00:00 PM
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim formats() As String = { "dd MMM yyyy hh:mm tt PST", 
                                  "dd MMM yyyy hh:mm tt PDT" }
      Dim dat As New Date(2016, 8, 18, 16, 50, 0)
      ' Display the result string. 
      Console.WriteLine(dat.ToString(formats(1)))
      
      ' Parse a string. 
      Dim value As String = "25 Dec 2016 12:00 pm PST"
      Dim newDate As Date
      If Date.TryParseExact(value, formats, Nothing, 
                            DateTimeStyles.None, newDate) Then 
         Console.WriteLine(newDate)
      Else
         Console.WriteLine("Unable to parse '{0}'", value)
      End If                               
   End Sub
End Module
' The example displays the following output:
'       18 Aug 2016 04:50 PM PDT
'       12/25/2016 12:00:00 PM

Il existe deux façons d’indiquer que les caractères doivent être interprétés comme des caractères littéraux, et non comme des caractères réservés, pour qu’ils puissent être inclus dans une chaîne de résultat ou analysés correctement dans une chaîne d’entrée :There are two ways to indicate that characters are to be interpreted as literal characters and not as reserve characters, so that they can be included in a result string or successfully parsed in an input string:

  • En plaçant chaque caractère réservé dans une séquence d’échappement.By escaping each reserved character. Pour plus d’informations, consultez Utilisation du caractère d’échappement.For more information, see Using the Escape Character.

    L’exemple suivant inclut les caractères littéraux « pst » (pour Pacific Standard Time, heure normale du Pacifique) pour représenter le fuseau horaire local dans une chaîne de format.The following example includes the literal characters "pst" (for Pacific Standard time) to represent the local time zone in a format string. Étant donné que « s » et « t » sont des chaînes de format personnalisées, les deux caractères doivent être placés dans des séquences d’échappement pour être interprétés comme des littéraux de caractères.Because both "s" and "t" are custom format strings, both characters must be escaped to be interpreted as character literals.

    using System;
    using System.Globalization;
    
    public class Example
    {
       public static void Main()
       {
          String format = "dd MMM yyyy hh:mm tt p\\s\\t";
          var dat = new DateTime(2016, 8, 18, 16, 50, 0);
          // Display the result string. 
          Console.WriteLine(dat.ToString(format));
          
          // Parse a string. 
          String value = "25 Dec 2016 12:00 pm pst";
          DateTime newDate;
          if (DateTime.TryParseExact(value, format, null, 
                                     DateTimeStyles.None, out newDate)) 
             Console.WriteLine(newDate);
          else
             Console.WriteLine("Unable to parse '{0}'", value);
       }
    }
    // The example displays the following output:
    //       18 Aug 2016 04:50 PM PDT
    //       12/25/2016 12:00:00 PM
    
    Imports System.Globalization
    
    Module Example
       Public Sub Main()
          Dim fmt As String = "dd MMM yyyy hh:mm tt p\s\t" 
          Dim dat As New Date(2016, 8, 18, 16, 50, 0)
          ' Display the result string. 
          Console.WriteLine(dat.ToString(fmt))
          
          ' Parse a string. 
          Dim value As String = "25 Dec 2016 12:00 pm pst"
          Dim newDate As Date
          If Date.TryParseExact(value, fmt, Nothing, 
                                DateTimeStyles.None, newDate) Then 
             Console.WriteLine(newDate)
          Else
             Console.WriteLine("Unable to parse '{0}'", value)
          End If                               
       End Sub
    End Module
    ' The example displays the following output:
    '       18 Aug 2016 04:50 PM pst
    '       12/25/2016 12:00:00 PM
    
  • En plaçant la totalité de la chaîne littérale entre guillemets ou apostrophes.By enclosing the entire literal string in quotation marks or apostrophes. L’exemple suivant est semblable au précédent, excepté que « pst » est placé entre guillemets pour indiquer que la totalité de la chaîne délimitée doit être interprétée comme des littéraux de caractères.The following example is like the previous one, except that "pst" is enclosed in quotation marks to indicate that the entire delimited string should be interpreted as character literals.

    using System;
    using System.Globalization;
    
    public class Example
    {
       public static void Main()
       {
          String format = "dd MMM yyyy hh:mm tt \"pst\"";
          var dat = new DateTime(2016, 8, 18, 16, 50, 0);
          // Display the result string. 
          Console.WriteLine(dat.ToString(format));
          
          // Parse a string. 
          String value = "25 Dec 2016 12:00 pm pst";
          DateTime newDate;
          if (DateTime.TryParseExact(value, format, null, 
                                     DateTimeStyles.None, out newDate)) 
             Console.WriteLine(newDate);
          else
             Console.WriteLine("Unable to parse '{0}'", value);
       }
    }
    // The example displays the following output:
    //       18 Aug 2016 04:50 PM PDT
    //       12/25/2016 12:00:00 PM
    
    Imports System.Globalization
    
    Module Example
       Public Sub Main()
          Dim fmt As String = "dd MMM yyyy hh:mm tt ""pst"""  
          Dim dat As New Date(2016, 8, 18, 16, 50, 0)
          ' Display the result string. 
          Console.WriteLine(dat.ToString(fmt))
          
          ' Parse a string. 
          Dim value As String = "25 Dec 2016 12:00 pm pst"
          Dim newDate As Date
          If Date.TryParseExact(value, fmt, Nothing, 
                                DateTimeStyles.None, newDate) Then 
             Console.WriteLine(newDate)
          Else
             Console.WriteLine("Unable to parse '{0}'", value)
          End If                               
       End Sub
    End Module
    ' The example displays the following output:
    '       18 Aug 2016 04:50 PM pst
    '       12/25/2016 12:00:00 PM
    

NotesNotes

Utilisation de spécificateurs de format personnalisés uniquesUsing single custom format specifiers

Une chaîne de format de date et d'heure personnalisée se compose d'au moins deux caractères.A custom date and time format string consists of two or more characters. Les méthodes de mise en forme de la date et de l'heure interprètent toute chaîne à un caractère comme une chaîne de format de date et d'heure standard.Date and time formatting methods interpret any single-character string as a standard date and time format string. Si elles ne reconnaissent pas le caractère comme un spécificateur de format valide, elles lèvent un FormatException.If they do not recognize the character as a valid format specifier, they throw a FormatException. Par exemple, une chaîne de format qui se compose uniquement du spécificateur "h" est interprétée comme une chaîne de format de date et d'heure standard.For example, a format string that consists only of the specifier "h" is interpreted as a standard date and time format string. Cependant, dans ce cas particulier, une exception est levée, car il n'existe pas spécificateur de format de date et d'heure "h" standard.However, in this particular case, an exception is thrown because there is no "h" standard date and timeformat specifier.

Pour utiliser tout spécificateur de format de date et d'heure personnalisé comme seul spécificateur dans une chaîne de format (autrement dit, utiliser le spécificateur de format personnalisé "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":" ou "/" tout seul), incluez un espace avant ou après le spécificateur, ou incluez un spécificateur de format pourcentage ("%") avant le spécificateur de date et d'heure personnalisé unique.To use any of the custom date and time format specifiers as the only specifier in a format string (that is, to use the "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":", or "/" custom format specifier by itself), include a space before or after the specifier, or include a percent ("%") format specifier before the single custom date and time specifier.

Par exemple », "%h"" est interprété en tant que chaîne de format de date et d'heure personnalisée qui affiche l'heure représentée par la valeur de date et d'heure actuelle.For example, "%h" is interpreted as a custom date and time format string that displays the hour represented by the current date and time value. Vous pouvez également utiliser la chaîne de format "h" ou "h", bien que cela inclue un espace avec l'heure dans la chaîne de résultat.You can also use the " h" or "h " format string, although this includes a space in the result string along with the hour. L'exemple suivant illustre ces trois chaînes de format.The following example illustrates these three format strings.

DateTime dat1 = new DateTime(2009, 6, 15, 13, 45, 0);

Console.WriteLine("'{0:%h}'", dat1);
Console.WriteLine("'{0: h}'", dat1);
Console.WriteLine("'{0:h }'", dat1);
// The example displays the following output:
//       '1'
//       ' 1'
//       '1 '
Dim dat1 As Date = #6/15/2009 1:45PM#

Console.WriteLine("'{0:%h}'", dat1)
Console.WriteLine("'{0: h}'", dat1)
Console.WriteLine("'{0:h }'", dat1)
' The example displays the following output:
'       '1'
'       ' 1'
'       '1 '

Utilisation du caractère d'échappementUsing the Escape Character

Les caractères "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":" ou "/" dans une chaîne de format sont interprétés comme des spécificateurs de format personnalisés plutôt que comme des caractères littéraux.The "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":", or "/" characters in a format string are interpreted as custom format specifiers rather than as literal characters. Pour éviter qu’un caractère soit interprété comme un spécificateur de format, vous pouvez le faire précéder d’une barre oblique inverse (\), qui est le caractère d’échappement.To prevent a character from being interpreted as a format specifier, you can precede it with a backslash (\), which is the escape character. Le caractère d'échappement signifie que le caractère suivant est un caractère littéral qui doit être inclus inchangé dans la chaîne de résultat.The escape character signifies that the following character is a character literal that should be included in the result string unchanged.

Pour inclure une barre oblique inverse dans une chaîne de résultat, vous devez la placer dans une séquence d'échappement avec une autre barre oblique inverse (\\).To include a backslash in a result string, you must escape it with another backslash (\\).

Note

Certains compilateurs, tels que les compilateurs C++ et C#, peuvent également interpréter une barre oblique inverse unique comme un caractère d'échappement.Some compilers, such as the C++ and C# compilers, may also interpret a single backslash character as an escape character. Pour garantir l'interprétation correcte d'une chaîne lors de la mise en forme, vous pouvez utiliser le caractère littéral de chaîne textuel(le caractère @) avant la chaîne en C#, ou ajouter une autre barre oblique inverse avant chaque barre oblique inverse en C# et C++.To ensure that a string is interpreted correctly when formatting, you can use the verbatim string literal character (the @ character) before the string in C#, or add another backslash character before each backslash in C# and C++. L'exemple C# suivant illustre ces deux approches.The following C# example illustrates both approaches.

L'exemple suivant utilise le caractère d'échappement pour empêcher l'opération de mise en forme d'interpréter les caractères "h" et "m" comme des spécificateurs de format.The following example uses the escape character to prevent the formatting operation from interpreting the "h" and "m" characters as format specifiers.

DateTime date = new DateTime(2009, 06, 15, 13, 45, 30, 90);
string fmt1 = "h \\h m \\m";
string fmt2 = @"h \h m \m";

Console.WriteLine("{0} ({1}) -> {2}", date, fmt1, date.ToString(fmt1));
Console.WriteLine("{0} ({1}) -> {2}", date, fmt2, date.ToString(fmt2));
// The example displays the following output:
//       6/15/2009 1:45:30 PM (h \h m \m) -> 1 h 45 m
//       6/15/2009 1:45:30 PM (h \h m \m) -> 1 h 45 m      
Dim date1 As Date = #6/15/2009 13:45#
Dim fmt As String = "h \h m \m"

Console.WriteLine("{0} ({1}) -> {2}", date1, fmt, date1.ToString(fmt))
' The example displays the following output:
'       6/15/2009 1:45:00 PM (h \h m \m) -> 1 h 45 m      

Paramètres du panneau de configurationControl Panel settings

Les paramètres Options régionales et linguistiques du Panneau de configuration influencent la chaîne de résultat produite par une opération de mise en forme qui inclut une grande partie des spécificateurs de format de date et d’heure personnalisés.The Regional and Language Options settings in Control Panel influence the result string produced by a formatting operation that includes many of the custom date and time format specifiers. 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, vous devez spécifier un objet CultureInfo qui représente une culture, ou un objet DateTimeFormatInfo.For the IFormatProvider parameter, you should specify a CultureInfo object, which represents a culture, or a DateTimeFormatInfo object.

La chaîne de résultat produite par la plupart des spécificateurs de format de date et d'heure personnalisés dépend également des propriétés de l'objet DateTimeFormatInfo actif.The result string produced by many of the custom date and time format specifiers also depends on 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 personnalisés en modifiant la propriété DateTimeFormatInfo correspondante.Your application can change the result produced by some custom date and time format specifiers by changing the corresponding DateTimeFormatInfo property. Par exemple, le spécificateur de format "ddd" ajoute à la chaîne de résultat le nom abrégé d'un jour de la semaine trouvé dans le tableau de chaînes AbbreviatedDayNames.For example, the "ddd" format specifier adds an abbreviated weekday name found in the AbbreviatedDayNames string array to the result string. De la même façon, le spécificateur de format "MMMM" ajoute à la chaîne de résultat un nom de mois complet trouvé dans le tableau de chaînes MonthNames.Similarly, the "MMMM" format specifier adds a full month name found in the MonthNames string array to the result string.

Voir aussiSee also