Chaînes de format de date et d'heure personnalisées
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. 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. 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. Toute chaîne autre qu'une chaîne de format de date et d'heure standard est interprétée comme chaîne de format de date et d'heure personnalisée.
Les chaînes de format de date et d'heure personnalisées peuvent être utilisées avec les valeurs DateTime et DateTimeOffset.
.gif "Conseil") Conseil |
|---|
Vous pouvez télécharger l'application Format Utility, qui vous permet d'appliquer des chaînes de format à des valeurs numériques ou des valeurs de date et d'heure. Elle permet également d'afficher la chaîne de résultat. |
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. L'exemple suivant illustre ces deux types d'utilisation.
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
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
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. 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. 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.
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.
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.
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. 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. Pour plus d'informations sur l'utilisation de chaînes de format de date et d'heure personnalisées, consultez la section Remarques.
Spécificateur de format |
Description |
Exemples |
|---|---|---|
"d" |
Jour du mois, de 1 à 31. Informations supplémentaires : Spécificateur de format personnalisé "d". |
6/1/2009 1:45:30 PM -> 1 6/15/2009 1:45:30 PM -> 15 |
"dd" |
Jour du mois, de 01 à 31. Informations supplémentaires : Spécificateur de format personnalisé "dd". |
6/1/2009 1:45:30 PM -> 01 6/15/2009 1:45:30 PM -> 15 |
"ddd" |
Nom abrégé du jour de la semaine. Informations supplémentaires : Spécificateur de format personnalisé "ddd". |
6/15/2009 1:45:30 PM -> Mon (en-US) 6/15/2009 1:45:30 PM -> Пн (ru-RU) 6/15/2009 1:45:30 PM -> lun. (fr-FR) |
"dddd" |
Nom complet du jour de la semaine. Informations supplémentaires : Spécificateur de format personnalisé "dddd". |
6/15/2009 1:45:30 PM -> Monday (en-US) 6/15/2009 1:45:30 PM -> понедельник (ru-RU) 6/15/2009 1:45:30 PM -> lundi (fr-FR) |
"f" |
Dixièmes de seconde dans une valeur de date et d'heure. Informations supplémentaires : Spécificateur de format personnalisé "f". |
6/15/2009 13:45:30.617 -> 6 6/15/2009 13:45:30.050 -> 0 |
"ff" |
Centièmes de seconde dans une valeur de date et d'heure. Informations supplémentaires : Spécificateur de format personnalisé "ff". |
6/15/2009 13:45:30.617 -> 61 6/15/2009 13:45:30.005 -> 00 |
"fff" |
Millisecondes dans une valeur de date et d'heure. Informations supplémentaires : Spécificateur de format personnalisé "fff". |
6/15/2009 13:45:30.617 -> 617 6/15/2009 13:45:30.0005 -> 000 |
"ffff" |
Dix millièmes de seconde dans une valeur de date et d'heure. Informations supplémentaires : Spécificateur de format personnalisé "ffff". |
6/15/2009 13:45:30.6175 -> 6175 6/15/2009 13:45:30.00005 -> 0000 |
"fffff" |
Cent millièmes de seconde dans une valeur de date et d'heure. Informations supplémentaires : Spécificateur de format personnalisé "fffff". |
6/15/2009 13:45:30.61754 -> 61754 6/15/2009 13:45:30.000005 -> 00000 |
"ffffff" |
Millionièmes de seconde dans une valeur de date et d'heure. Informations supplémentaires : Spécificateur de format personnalisé "ffffff". |
6/15/2009 13:45:30.617542 -> 617542 6/15/2009 13:45:30.0000005 -> 000000 |
"fffffff" |
Dix millionièmes de seconde dans une valeur de date et d'heure. Informations supplémentaires : Spécificateur de format personnalisé "fffffff". |
6/15/2009 13:45:30.6175425 -> 6175425 6/15/2009 13:45:30.0001150 -> 0001150 |
"F" |
Si la valeur est différente de zéro, dixièmes de seconde dans une valeur de date et d'heure. Informations supplémentaires : Spécificateur de format personnalisé "F". |
6/15/2009 13:45:30.617 -> 6 6/15/2009 13:45:30.050 -> (aucune sortie) |
"FF" |
Si la valeur est différente de zéro, centièmes de seconde dans une valeur de date et d'heure. Informations supplémentaires : Spécificateur de format personnalisé "FF". |
6/15/2009 13:45:30.617 -> 61 6/15/2009 13:45:30.005 -> (aucune sortie) |
"FFF" |
Si la valeur est différente de zéro, millisecondes dans une valeur de date et d'heure. Informations supplémentaires : Spécificateur de format personnalisé "FFF". |
6/15/2009 13:45:30.617 -> 617 6/15/2009 13:45:30.0005 -> (aucune sortie) |
"FFFF" |
Si la valeur est différente de zéro, dix millièmes de seconde dans une valeur de date et d'heure. Informations supplémentaires : Spécificateur de format personnalisé "FFFF". |
6/1/2009 13:45:30.5275 -> 5275 6/15/2009 13:45:30.00005 -> (aucune sortie) |
"FFFFF" |
Si la valeur est différente de zéro, cent millièmes de seconde dans une valeur de date et d'heure. Informations supplémentaires : Spécificateur de format personnalisé "FFFFF". |
6/15/2009 13:45:30.61754 -> 61754 6/15/2009 13:45:30.000005 -> (aucune sortie) |
"FFFFFF" |
Si la valeur est différente de zéro, millionièmes de seconde dans une valeur de date et d'heure. Informations supplémentaires : Spécificateur de format personnalisé "FFFFFF". |
6/15/2009 13:45:30.617542 -> 617542 6/15/2009 13:45:30.0000005 -> (aucune sortie) |
"FFFFFFF" |
Si la valeur est différente de zéro, dix millionièmes de seconde dans une valeur de date et d'heure. Informations supplémentaires : Spécificateur de format personnalisé "FFFFFFF". |
6/15/2009 13:45:30.6175425 -> 6175425 6/15/2009 13:45:30.0001150 -> 000115 |
"g", "gg" |
Période ou ère. Informations supplémentaires : Spécificateur de format personnalisé "g" ou "gg". |
6/15/2009 1:45:30 PM -> A.D. |
"h" |
Heure, au format de 12 heures, de 1 à 12. Informations supplémentaires : Spécificateur de format personnalisé "h". |
6/15/2009 1:45:30 AM -> 1 6/15/2009 1:45:30 PM -> 1 |
"hh" |
Heure, au format de 12 heures, de 01 à 12. Informations supplémentaires : Spécificateur de format personnalisé "hh". |
6/15/2009 1:45:30 AM -> 01 6/15/2009 1:45:30 PM -> 01 |
"H" |
Heure, au format de 24 heures, de 0 à 23. Informations supplémentaires : Spécificateur de format personnalisé "H". |
6/15/2009 1:45:30 AM -> 1 6/15/2009 1:45:30 PM -> 13 |
"HH" |
Heure, au format de 24 heures, de 00 à 23. Informations supplémentaires : Spécificateur de format personnalisé "HH". |
6/15/2009 1:45:30 AM -> 01 6/15/2009 1:45:30 PM -> 13 |
"K" |
Informations sur les fuseaux horaires. Informations supplémentaires : Spécificateur de format personnalisé "K". |
Avec les valeurs DateTime : 6/15/2009 1:45:30 PM, Kind Unspecified -> 6/15/2009 1:45:30 PM, Kind Utc -> Z 6/15/2009 1:45:30 PM, Kind Local -> -07:00 (en fonction des paramètres locaux de l'ordinateur) Avec les valeurs DateTimeOffset : 6/15/2009 1:45:30 AM -07:00 --> -07:00 6/15/2009 8:45:30 AM +00:00 --> +00:00 |
"m" |
Minute, entre 0 et 59. Informations supplémentaires : Spécificateur de format personnalisé "m". |
6/15/2009 1:09:30 AM -> 9 6/15/2009 1:09:30 PM -> 9 |
"mm" |
Minute, de 00 à 59. Informations supplémentaires : Spécificateur de format personnalisé "mm". |
6/15/2009 1:09:30 AM -> 09 6/15/2009 1:09:30 PM -> 09 |
"M" |
Mois, de 1 à 12. Informations supplémentaires : Spécificateur de format personnalisé "M". |
6/15/2009 1:45:30 PM -> 6 |
"MM" |
Mois, de 01 à 12. Informations supplémentaires : Spécificateur de format personnalisé "MM". |
6/15/2009 1:45:30 PM -> 06 |
"MMM" |
Nom abrégé du mois. Informations supplémentaires : Spécificateur de format personnalisé "MMM". |
6/15/2009 1:45:30 PM -> Jun (en-US) 6/15/2009 1:45:30 PM -> juin (fr-FR) 6/15/2009 1:45:30 PM -> Jun (zu-ZA) |
"MMMM" |
Nom complet du mois. Informations supplémentaires : Spécificateur de format personnalisé "MMMM". |
6/15/2009 1:45:30 PM -> June (en-US) 6/15/2009 1:45:30 PM -> juni (da-DK) 6/15/2009 1:45:30 PM -> uJuni (zu-ZA) |
"s" |
Seconde, de 0 à 59. Informations supplémentaires : Spécificateur de format personnalisé "s". |
6/15/2009 1:45:09 PM -> 9 |
"ss" |
Seconde, de 00 à 59. Informations supplémentaires : Spécificateur de format personnalisé "ss". |
6/15/2009 1:45:09 PM -> 09 |
"t" |
Premier caractère de l'indicateur AM/PM. Informations supplémentaires : Spécificateur de format personnalisé "t". |
6/15/2009 1:45:30 PM -> P (en-US) 6/15/2009 1:45:30 PM -> 午 (ja-JP) 6/15/2009 1:45:30 PM -> (fr-FR) |
"tt" |
Indicateur AM/PM. Informations supplémentaires : Spécificateur de format personnalisé "tt". |
6/15/2009 1:45:30 PM -> PM (en-US) 6/15/2009 1:45:30 PM -> 午後 (ja-JP) 6/15/2009 1:45:30 PM -> (fr-FR) |
"y" |
Année, de 0 à 99. Informations supplémentaires : Spécificateur de format personnalisé "y". |
1/1/0001 12:00:00 AM -> 1 1/1/0900 12:00:00 AM -> 0 1/1/1900 12:00:00 AM -> 0 6/15/2009 1:45:30 PM -> 9 |
"yy" |
Année, de 00 à 99. Informations supplémentaires : Spécificateur de format personnalisé "yy". |
1/1/0001 12:00:00 AM -> 01 1/1/0900 12:00:00 AM -> 00 1/1/1900 12:00:00 AM -> 00 6/15/2009 1:45:30 PM -> 09 |
"yyy" |
Année, avec au minimum trois chiffres. Informations supplémentaires : Spécificateur de format personnalisé "yyy". |
1/1/0001 12:00:00 AM -> 001 1/1/0900 12:00:00 AM -> 900 1/1/1900 12:00:00 AM -> 1900 6/15/2009 1:45:30 PM -> 2009 |
"yyyy" |
Année, sous la forme d'un nombre de quatre chiffres. Informations supplémentaires : Spécificateur de format personnalisé "yyyy". |
1/1/0001 12:00:00 AM -> 0001 1/1/0900 12:00:00 AM -> 0900 1/1/1900 12:00:00 AM -> 1900 6/15/2009 1:45:30 PM -> 2009 |
"yyyyy" |
Année, sous la forme d'un nombre de cinq chiffres. Informations supplémentaires : Spécificateur de format personnalisé "yyyyy". |
1/1/0001 12:00:00 AM -> 00001 6/15/2009 1:45:30 PM -> 02009 |
"z" |
Offset des heures par rapport à l'heure UTC, sans zéro non significatif. Informations supplémentaires : Spécificateur de format personnalisé "z". |
6/15/2009 1:45:30 PM -07:00 -> -7 |
"zz" |
Offset des heures par rapport à l'heure UTC, avec un zéro non significatif pour une valeur à un seul chiffre. Informations supplémentaires : Spécificateur de format personnalisé "zz". |
6/15/2009 1:45:30 PM -07:00 -> -07 |
"zzz" |
Offset par rapport à l'heure UTC, en heures et minutes. Informations supplémentaires : Spécificateur de format personnalisé "zzz". |
6/15/2009 1:45:30 PM -07:00 -> -07:00 |
":" |
Séparateur d'heure. Informations supplémentaires : Spécificateur de format personnalisé ":". |
6/15/2009 1:45:30 PM -> : (en-US) 6/15/2009 1:45:30 PM -> . (it-IT) 6/15/2009 1:45:30 PM -> : (ja-JP) |
"/" |
Séparateur de date. Informations supplémentaires : Spécificateur de format personnalisé "/". |
6/15/2009 1:45:30 PM -> / (en-US) 6/15/2009 1:45:30 PM -> - (ar-DZ) 6/15/2009 1:45:30 PM -> . (tr-TR) |
"chaîne" 'chaîne' |
Délimiteur de chaîne littérale. |
6/15/2009 1:45:30 PM ("arr:" h:m t) -> arr: 1:45 P 6/15/2009 1:45:30 PM ('arr :' h:m t) -> arr : 1:45 P |
% |
Définit le caractère suivant comme un spécificateur de format personnalisé. Informations supplémentaires :Utilisation de spécificateurs de format personnalisés uniques. |
6/15/2009 1:45:30 PM (%h) -> 1 |
\ |
Caractère d'échappement. |
6/15/2009 1:45:30 PM (h \h) -> 1 h |
N'importe quel autre caractère |
Le caractère est copié inchangé dans la chaîne de résultat. Informations supplémentaires : Utilisation du caractère d'échappement. |
6/15/2009 1:45:30 AM (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é. 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.
Spécificateur de format personnalisé "d"
Le spécificateur de format personnalisé "d" représente le jour du mois sous la forme d'un nombre compris entre 1 et 31. Un jour à un seul chiffre est mis en forme sans zéro non significatif.
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". 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.
L'exemple suivant inclut le spécificateur de format personnalisé "d" dans plusieurs chaînes de format.
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
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
Retour au tableau
Spécificateur de format personnalisé "dd"
Le spécificateur de format personnalisé "dd" représente le jour du mois sous la forme d'un nombre compris entre 01 et 31. Un jour à un seul chiffre est mis en forme avec un zéro non significatif.
L'exemple suivant inclut le spécificateur de format personnalisé "dd" dans une chaîne de format personnalisée.
Dim date1 As Date = #1/2/2008 6:30:15AM#
Console.WriteLine(date1.ToString("dd, MM", _
CultureInfo.InvariantCulture))
' 02, 01
DateTime date1 = new DateTime(2008, 1, 2, 6, 30, 15);
Console.WriteLine(date1.ToString("dd, MM",
CultureInfo.InvariantCulture));
// 02, 01
Retour au tableau
Spécificateur de format personnalisé "ddd"
Le spécificateur de format personnalisé "ddd" représente le nom abrégé du jour de la semaine. 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.
L'exemple suivant inclut le spécificateur de format personnalisé "ddd" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "dddd"
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. 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.
L'exemple suivant inclut le spécificateur de format personnalisé "dddd" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "f"
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.
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". 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.
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.
L'exemple suivant inclut le spécificateur de format personnalisé "f" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "ff"
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.
L'exemple suivant inclut le spécificateur de format personnalisé "ff" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "fff"
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.
L'exemple suivant inclut le spécificateur de format personnalisé "fff" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "ffff"
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.
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. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. 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.
Retour au tableau
Spécificateur de format personnalisé "fffff"
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.
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. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. 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.
Retour au tableau
Spécificateur de format personnalisé "ffffff"
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.
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. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. 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.
Retour au tableau
Spécificateur de format personnalisé "fffffff"
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.
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. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. 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.
Retour au tableau
Spécificateur de format personnalisé "F"
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. Rien ne s'affiche si le chiffre est zéro.
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". 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.
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.
L'exemple suivant inclut le spécificateur de format personnalisé "F" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "FF"
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. Toutefois, les zéros de fin ou deux chiffres zéro ne sont pas affichés.
L'exemple suivant inclut le spécificateur de format personnalisé "FF" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "FFF"
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. Toutefois, les zéros de fin ou trois chiffres zéro ne sont pas affichés.
L'exemple suivant inclut le spécificateur de format personnalisé "FFF" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "FFFF"
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. Toutefois, les zéros de fin ou quatre chiffres zéro ne sont pas affichés.
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. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. 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.
Retour au tableau
Spécificateur de format personnalisé "FFFFF"
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. Toutefois, les zéros de fin ou cinq chiffres zéro ne sont pas affichés.
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. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. 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.
Retour au tableau
Spécificateur de format personnalisé "FFFFFF"
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. Toutefois, les zéros de fin ou six chiffres zéro ne sont pas affichés.
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. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. 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.
Retour au tableau
Spécificateur de format personnalisé "FFFFFFF"
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. Toutefois, les zéros de fin ou sept chiffres zéro ne sont pas affichés.
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. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. 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.
Retour au tableau
Spécificateur de format personnalisé "g" ou "gg"
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. 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.
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". 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.
L'exemple suivant inclut le spécificateur de format personnalisé "g" dans une chaîne de format personnalisée.
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.
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.
Retour au tableau
Spécificateur de format personnalisé "h"
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. Une heure après minuit se présente de la même manière que la même heure après midi. L'heure n'est pas arrondie et une heure à un seul chiffre est mise en forme sans zéro non significatif. 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".
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. 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.
L'exemple suivant inclut le spécificateur de format personnalisé "h" dans une chaîne de format personnalisée.
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 µ
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 µ
Retour au tableau
Spécificateur de format personnalisé "hh"
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. Une heure après minuit se présente de la même manière que la même heure après midi. L'heure n'est pas arrondie et une heure à un seul chiffre est mise en forme avec un zéro non significatif. 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".
L'exemple suivant inclut le spécificateur de format personnalisé "hh" dans une chaîne de format personnalisée.
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.
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.
Retour au tableau
Spécificateur de format personnalisé "H"
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. Une heure à un seul chiffre est mise en forme sans zéro non significatif.
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. 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.
L'exemple suivant inclut le spécificateur de format personnalisé "H" dans une chaîne de format personnalisée.
Dim date1 As Date = #6:09:01AM#
Console.WriteLine(date1.ToString("H:mm:ss", _
CultureInfo.InvariantCulture))
' Displays 6:09:01
DateTime date1 = new DateTime(2008, 1, 1, 6, 9, 1);
Console.WriteLine(date1.ToString("H:mm:ss",
CultureInfo.InvariantCulture));
// Displays 6:09:01
Retour au tableau
Spécificateur de format personnalisé "HH"
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. Une heure à un seul chiffre est mise en forme avec un zéro non significatif.
L'exemple suivant inclut le spécificateur de format personnalisé "HH" dans une chaîne de format personnalisée.
Dim date1 As Date = #6:09:01AM#
Console.WriteLine(date1.ToString("HH:mm:ss", _
CultureInfo.InvariantCulture))
' Displays 06:09:01
DateTime date1 = new DateTime(2008, 1, 1, 6, 9, 1);
Console.WriteLine(date1.ToString("HH:mm:ss",
CultureInfo.InvariantCulture));
// Displays 06:09:01
Retour au tableau
Spécificateur de format personnalisé "K"
Le spécificateur de format personnalisé "K" représente les informations de fuseau horaire d'une valeur de date et d'heure. 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 :
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".
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.
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.
Pour les valeurs DateTimeOffset, le spécificateur de format "K" est équivalent au spécificateur de format "zz", et produit une chaîne de résultat contenant l'offset de la valeur DateTimeOffset par rapport à l'heure 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. 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.
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).
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
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
Retour au tableau
Spécificateur de format personnalisé "m"
Le spécificateur de format personnalisé "m" représente la minute sous la forme d'un nombre compris entre 0 et 59. La minute représente les minutes entières qui se sont écoulées depuis la dernière heure. Une minute à un seul chiffre est mise en forme sans zéro non significatif.
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". 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.
L'exemple suivant inclut le spécificateur de format personnalisé "m" dans une chaîne de format personnalisée.
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 µ
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 µ
Retour au tableau
Spécificateur de format personnalisé "mm"
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. La minute représente les minutes entières qui se sont écoulées depuis la dernière heure. Une minute à un seul chiffre est mise en forme avec un zéro non significatif.
L'exemple suivant inclut le spécificateur de format personnalisé "mm" dans une chaîne de format personnalisée.
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.
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.
Retour au tableau
Spécificateur de format personnalisé "M"
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). Un mois à un seul chiffre est mis en forme sans zéro non significatif.
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". 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.
L'exemple suivant inclut le spécificateur de format personnalisé "M" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "MM"
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). Un mois à un seul chiffre est mis en forme avec un zéro non significatif.
L'exemple suivant inclut le spécificateur de format personnalisé "MM" dans une chaîne de format personnalisée.
Dim date1 As Date = #1/2/2008 6:30:15AM#
Console.WriteLine(date1.ToString("dd, MM", _
CultureInfo.InvariantCulture))
' 02, 01
DateTime date1 = new DateTime(2008, 1, 2, 6, 30, 15);
Console.WriteLine(date1.ToString("dd, MM",
CultureInfo.InvariantCulture));
// 02, 01
Retour au tableau
Spécificateur de format personnalisé "MMM"
Le spécificateur de format personnalisé "MMM" représente le nom abrégé du mois. 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.
L'exemple suivant inclut le spécificateur de format personnalisé "MMM" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "MMMM"
Le spécificateur de format personnalisé "MMMM" représente le nom complet du mois. Le nom localisé du mois est récupéré de la propriété DateTimeFormatInfo.MonthNames de la culture actuelle ou spécifiée.
L'exemple suivant inclut le spécificateur de format personnalisé "MMMM" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "s"
Le spécificateur de format personnalisé "s" représente les secondes sous la forme d'un nombre compris entre 0 et 59. Le résultat représente les secondes entières qui se sont écoulées depuis la dernière minute. Une seconde à un seul chiffre est mise en forme sans zéro non significatif.
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". 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.
L'exemple suivant inclut le spécificateur de format personnalisé "s" dans une chaîne de format personnalisée.
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 µ
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 µ
Retour au tableau
Spécificateur de format personnalisé "ss"
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. Le résultat représente les secondes entières qui se sont écoulées depuis la dernière minute. Une seconde à un seul chiffre est mise en forme avec un zéro non significatif.
L'exemple suivant inclut le spécificateur de format personnalisé "ss" dans une chaîne de format personnalisée.
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.
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.
Retour au tableau
Spécificateur de format personnalisé "t"
Le spécificateur de format personnalisé "t" représente le premier caractère de l'indicateur AM/PM. L'indicateur localisé approprié est récupéré de la propriété DateTimeFormatInfo.AMDesignator ou DateTimeFormatInfo.PMDesignator de la culture actuelle ou spécifique. L'indicateur AM est utilisé pour toutes les heures comprises entre 0:00:00 (minuit) et 11:59:59.999. L'indicateur PM est utilisé pour toutes les heures comprises entre 12:00:00 (midi) et 23:59:59.99.
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". 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.
L'exemple suivant inclut le spécificateur de format personnalisé "t" dans une chaîne de format personnalisée.
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 µ
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 µ
Retour au tableau
Spécificateur de format personnalisé "tt"
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. L'indicateur localisé approprié est récupéré de la propriété DateTimeFormatInfo.AMDesignator ou DateTimeFormatInfo.PMDesignator de la culture actuelle ou spécifique. L'indicateur AM est utilisé pour toutes les heures comprises entre 0:00:00 (minuit) et 11:59:59.999. L'indicateur PM est utilisé pour toutes les heures comprises entre 12:00:00 (midi) et 23:59:59.99.
Veillez à utiliser le spécificateur "tt" pour les langues pour lesquelles il est nécessaire de maintenir la distinction entre AM et 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.
L'exemple suivant inclut le spécificateur de format personnalisé "tt" dans une chaîne de format personnalisée.
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.
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.
Retour au tableau
Spécificateur de format personnalisé "y"
Le spécificateur de format personnalisé "y" représente l'année sous la forme d'un nombre à un chiffre ou à deux chiffres. Si l'année comporte plus de deux chiffres, seuls les deux chiffres de poids faible apparaissent dans le résultat. 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.
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". 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.
L'exemple suivant inclut le spécificateur de format personnalisé "y" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "yy"
Le spécificateur de format personnalisé "yy" représente l'année sous la forme d'un nombre à deux chiffres. Si l'année comporte plus de deux chiffres, seuls les deux chiffres de poids faible apparaissent dans le résultat. Si l'année sur deux chiffres comporte moins de deux chiffres significatifs, le nombre est rempli avec des zéros non significatifs pour produire deux chiffres.
L'exemple suivant inclut le spécificateur de format personnalisé "yy" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "yyy"
Le spécificateur de format personnalisé "yyy" représente l'année avec un minimum de trois chiffres. Si l'année comporte plus de trois chiffres significatifs, ils sont inclus dans la chaîne résultante. Si l'année comporte moins de trois chiffres, le nombre est rempli avec des zéros non significatifs pour produire trois chiffres.
| Remarque |
|---|
Pour le calendrier bouddhiste thaïlandais, qui peut comporter des années à cinq chiffres, ce spécificateur de format affiche tous les chiffres significatifs. |
L'exemple suivant inclut le spécificateur de format personnalisé "yyy" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "yyyy"
Le spécificateur de format personnalisé "yyyy" représente l'année avec un minimum de quatre chiffres. Si l'année comporte plus de quatre chiffres significatifs, ils sont inclus dans la chaîne résultante. Si l'année comporte moins de quatre chiffres, le nombre est rempli à l'aide de zéros non significatifs pour produire quatre chiffres.
| Remarque |
|---|
Pour le calendrier bouddhiste thaïlandais, qui peut comporter des années à cinq chiffres, ce spécificateur de format affiche au minimum quatre chiffres. |
L'exemple suivant inclut le spécificateur de format personnalisé "yyyy" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "yyyyy"
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. Si l'année comporte plus de cinq chiffres significatifs, ils sont inclus dans la chaîne résultante. Si l'année comporte moins de cinq chiffres, le nombre est rempli avec des zéros non significatifs pour produire cinq chiffres.
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".
L'exemple suivant inclut le spécificateur de format personnalisé "yyyyy" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "z"
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. Il ne reflète pas la valeur de la propriété DateTime.Kind d'une instance. C'est pourquoi il n'est pas recommandé d'utiliser le spécificateur de format "z" avec les valeurs DateTime.
Avec les valeurs DateTimeOffset, ce spécificateur de format représente l'offset de la valeur DateTimeOffset par rapport à l'heure UTC, en heures.
L'offset est toujours affiché avec un signe de début. Un signe plus (+) indique les heures avant l'heure UTC, et un signe moins (-) indique les heures après l'heure UTC. Un offset à un seul chiffre est mis en forme sans zéro non significatif.
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. 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.
L'exemple suivant inclut le spécificateur de format personnalisé "z" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "zz"
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. Il ne reflète pas la valeur de la propriété DateTime.Kind d'une instance. C'est pourquoi il n'est pas recommandé d'utiliser le spécificateur de format "zz" avec les valeurs DateTime.
Avec les valeurs DateTimeOffset, ce spécificateur de format représente l'offset de la valeur DateTimeOffset par rapport à l'heure UTC, en heures.
L'offset est toujours affiché avec un signe de début. Un signe plus (+) indique les heures avant l'heure UTC, et un signe moins (-) indique les heures après l'heure UTC. Un offset à un seul chiffre est mis en forme avec un zéro non significatif.
L'exemple suivant inclut le spécificateur de format personnalisé "zz" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé "zzz"
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. Il ne reflète pas la valeur de la propriété DateTime.Kind d'une instance. C'est pourquoi il n'est pas recommandé d'utiliser le spécificateur de format "zzz" avec les valeurs DateTime.
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.
L'offset est toujours affiché avec un signe de début. Un signe plus (+) indique les heures avant l'heure UTC, et un signe moins (-) indique les heures après l'heure UTC. Un offset à un seul chiffre est mis en forme avec un zéro non significatif.
L'exemple suivant inclut le spécificateur de format personnalisé "zzz" dans une chaîne de format personnalisée.
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
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
Retour au tableau
Spécificateur de format personnalisé ":"
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. 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.
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. 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.
Retour au tableau
Spécificateur de format personnalisé "/"
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. 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.
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. 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.
Retour au tableau
Remarques
Utilisation de spécificateurs de format personnalisés uniques
Une chaîne de format de date et d'heure personnalisée se compose d'au moins deux caractères. 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. Si elles ne reconnaissent pas le caractère comme un spécificateur de format valide, elles lèvent un 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. Toutefois, dans ce cas particulier, une exception est levée, car il n'existe aucun spécificateur de format de date et d'heure "h" standard.
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.
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. 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. L'exemple suivant illustre ces trois chaînes de format.
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 '
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 '
Utilisation du caractère d'échappement
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. 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. 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.
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 (\\).
| Remarque |
|---|
Certains compilateurs, tels que les compilateurs C++ et C#, peuvent également interpréter une barre oblique inverse unique comme un caractère d'échappement.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++.L'exemple C# suivant illustre ces deux approches. |
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.
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
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
Paramètres du panneau de configuration
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. Ces paramètres sont utilisés pour initialiser l'objet DateTimeFormatInfo associé à la culture du thread en cours qui fournit des valeurs utilisées pour indiquer la mise en forme. Les ordinateurs qui utilisent des paramètres différents génèrent des chaînes de résultat différentes.
De plus, si vous utilisez le constructeur CultureInfo.CultureInfo(String) pour instancier un nouvel objet CultureInfo qui représente la même culture que la culture système en cours, toutes les personnalisations établies par l'élément Options régionales et linguistiques du Panneau de configuration seront appliquées au nouvel objet CultureInfo. Vous pouvez utiliser le constructeur CultureInfo.CultureInfo(String, Boolean) pour créer un objet CultureInfo qui ne reflète pas les personnalisations d'un système.
Propriétés DateTimeFormatInfo
La mise en forme dépend des propriétés de l'objet DateTimeFormatInfo actif, qui est fourni implicitement par la culture actuelle du thread ou explicitement par le paramètre IFormatProvider de la méthode qui appelle la mise en forme. Pour le paramètre IFormatProvider, vous devez spécifier un objet CultureInfo qui représente une culture, ou un objet DateTimeFormatInfo.
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. 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. 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. 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.
Voir aussi
Référence
Concepts
Chaînes de format de date et d'heure standard
Historique des modifications
Date |
Historique |
Motif |
|---|---|---|
|
Mars 2011 |
Ajout d'un lien vers l'utilitaire de formatage. |
Améliorations apportées aux informations. |
|
Juillet 2010 |
Ajout d'informations sur l'utilisation de chaînes de format personnalisées dans les opérations de mise en forme et d'analyse. |
Commentaires client. |