Partager via

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

  • Article

Mise à jour : novembre 2007

Une chaîne de format de date et d'heure personnalisée définit la représentation textuelle d'une valeur DateTime ou DateTimeOffset produite par une opération de mise en forme. La 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.

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

Spécificateurs de format de date et d'heure personnalisés

Le tableau suivant décrit les spécificateurs de format de date et d'heure personnalisés. Sauf indication contraire, un spécificateur de format de date et d'heure personnalisé particulier 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

Description

d

Représente le jour du mois sous la forme d'un nombre compris entre 1 et 31. Les jours à un seul chiffre sont mis en forme sans zéro non significatif. Pour plus d'informations sur l'utilisation d'un spécificateur de format personnalisé unique, consultez Utilisation de spécificateurs de format personnalisés uniques.

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

dd

Représente le jour du mois sous la forme d'un nombre compris entre 01 et 31. Les jours à un seul chiffre sont 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

ddd

Représente le nom abrégé du jour de la semaine tel qu'il est défini dans la propriété DateTimeFormatInfo.AbbreviatedDayNames en cours. 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 aot                                                
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 aot

dddd (plus n'importe quel nombre de spécificateurs d supplémentaires)

Représente le nom complet du jour de la semaine tel qu'il est défini dans la propriété DateTimeFormatInfo.DayNames en cours. 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

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.

En cas d'utilisation dans le cadre d'une chaîne de format fournie aux méthodes ParseExact, TryParseExact, ParseExact ou TryParseExact, le nombre de spécificateurs de format f utilisé 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

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

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

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. Sous Windows NT 3.5 et versions ultérieures, ainsi que sous les systèmes d'exploitation Windows Vista, la résolution de l'horloge est d'environ 10-15 millisecondes.

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. Sous Windows NT 3.5 et versions ultérieures, ainsi que sous les systèmes d'exploitation Windows Vista, la résolution de l'horloge est d'environ 10-15 millisecondes.

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. Sous Windows NT 3.5 et versions ultérieures, ainsi que sous les systèmes d'exploitation Windows Vista, la résolution de l'horloge est d'environ 10-15 millisecondes.

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. Sous Windows NT 3.5 et versions ultérieures, ainsi que sous les systèmes d'exploitation Windows Vista, la résolution de l'horloge est d'environ 10-15 millisecondes.

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.

Le nombre de spécificateurs de format F utilisé avec les méthodes 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

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

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

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. Sous Windows NT 3.5 et versions ultérieures, ainsi que sous les systèmes d'exploitation Windows Vista, la résolution de l'horloge est d'environ 10-15 millisecondes.

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. Sous Windows NT 3.5 et versions ultérieures, ainsi que sous les systèmes d'exploitation Windows Vista, la résolution de l'horloge est d'environ 10-15 millisecondes.

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. Sous Windows NT 3.5 et versions ultérieures, ainsi que sous les systèmes d'exploitation Windows Vista, la résolution de l'horloge est d'environ 10-15 millisecondes.

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. Sous Windows NT 3.5 et versions ultérieures, ainsi que sous les systèmes d'exploitation Windows Vista, la résolution de l'horloge est d'environ 10-15 millisecondes.

g, gg (plus n'importe quel nombre de spécificateurs g supplémentaires)

Représente la période ou l'ère, après J.-C. par exemple. La mise en forme ignore ce spécificateur si la date à laquelle appliquer un format n'est associée à aucune chaîne de période ou d'ère. Pour plus d'informations sur l'utilisation d'un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques.

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.

h

Représente l'heure sous la forme d'un nombre compris entre 1 et 12, c'est-à-dire l'heure telle qu'elle est représentée par une horloge au format 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, ce spécificateur de format personnalisé affiche "5". Pour plus d'informations sur l'utilisation d'un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques.

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

hh, 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, c'est-à-dire l'heure telle qu'elle est représentée par une horloge au format 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, 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.FF tt", _


                  CultureInfo.InvariantCulture))


' Displays 06:09:01 PM                        


Console.WriteLine(date1.ToString("hh:mm:ss.FF 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.FF tt", 


                  CultureInfo.InvariantCulture));


// Displays 06:09:01 PM                        


Console.WriteLine(date1.ToString("hh:mm:ss.FF 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.

H

Représente l'heure sous la forme d'un nombre compris entre 0 et 23, c'est-à-dire l'heure telle qu'elle est représentée par une horloge au format 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.

Pour plus d'informations sur l'utilisation d'un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques.

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

HH, 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, c'est-à-dire l'heure telle qu'elle est représentée par une horloge au format 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

K

Représente les informations de fuseau horaire d'une valeur de date et d'heure. En cas d'utilisation avec les valeurs DateTime, la chaîne résultante 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 résultante 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 résultante 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 est égale à 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 résultante contenant l'offset de la valeur DateTimeOffset par rapport à l'heure UTC.

Pour plus d'informations sur l'utilisation d'un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques.

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

m

Représente la minute sous la forme d'un nombre compris entre 0 et 59. La minute représente les minutes entières écoulées depuis la dernière heure. Une minute à un seul chiffre est mise en forme sans zéro non significatif. Pour plus d'informations sur l'utilisation d'un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques. 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

mm, 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 é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.FF tt", _


                  CultureInfo.InvariantCulture))


' Displays 06:09:01 PM                        


Console.WriteLine(date1.ToString("hh:mm:ss.FF 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.FF tt", 


                  CultureInfo.InvariantCulture));


// Displays 06:09:01 PM                        


Console.WriteLine(date1.ToString("hh:mm:ss.FF 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.

M

Représente le mois sous la forme d'un nombre compris entre 1 et 12. Un mois à un seul chiffre est mis en forme sans zéro non significatif. Pour plus d'informations sur l'utilisation d'un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques. 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

MM

Représente le mois sous la forme d'un nombre compris entre 01 et 12. 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

MMM

Représente le nom abrégé du mois tel qu'il est défini dans la propriété DateTimeFormatInfo.AbbreviatedMonthNames en cours. 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 aot                                                
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 aot

MMMM

Représente le nom complet du mois tel qu'il est défini dans la propriété DateTimeFormatInfo.MonthNames en cours. 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

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 écoulées depuis la dernière minute. Une seconde à un seul chiffre est mise en forme sans zéro non significatif. Pour plus d'informations sur l'utilisation d'un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques. 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

ss, 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 é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.FF tt", _


                  CultureInfo.InvariantCulture))


' Displays 06:09:01 PM                        


Console.WriteLine(date1.ToString("hh:mm:ss.FF 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.FF tt", 


                  CultureInfo.InvariantCulture));


// Displays 06:09:01 PM                        


Console.WriteLine(date1.ToString("hh:mm:ss.FF 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.

t

Représente le premier caractère de l'indicateur AM/PM défini dans la propriété DateTimeFormatInfo.AMDesignator ou DateTimeFormatInfo.PMDesignator en cours. L'indicateur AM est utilisé si l'heure mise en forme est inférieure à 12 ; sinon, l'indicateur PM est utilisé. Pour plus d'informations sur l'utilisation d'un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques.

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

tt, tt (plus n'importe quel nombre de spécificateurs t supplémentaires)

Représente l'indicateur AM/PM tel qu'il est défini dans la propriété DateTimeFormatInfo.AMDesignator ou DateTimeFormatInfo.PMDesignator en cours. L'indicateur AM est utilisé si l'heure mise en forme est inférieure à 12 ; sinon, l'indicateur PM est utilisé.

Votre application doit garantir l'utilisation du spécificateur tt pour les langues nécessitant 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.FF tt", _


                  CultureInfo.InvariantCulture))


' Displays 06:09:01 PM                        


Console.WriteLine(date1.ToString("hh:mm:ss.FF 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.FF tt", 


                  CultureInfo.InvariantCulture));


// Displays 06:09:01 PM                        


Console.WriteLine(date1.ToString("hh:mm:ss.FF 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.

y

Représente l'année sous la forme d'un nombre à un 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. Pour plus d'informations sur l'utilisation d'un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques.

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

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 à l'aide de zéros non significatifs pour atteindre 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

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 à l'aide de zéros non significatifs pour atteindre trois chiffres.

Notez que pour le calendrier bouddhiste thaïlandais, qui peut comporter des années à cinq chiffres, ce spécificateur de format affiche les cinq chiffres.

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

yyyy

Représente l'année sous la forme d'un nombre à quatre chiffres. Si l'année comporte plus de quatre chiffres, seuls les quatre chiffres de poids faible apparaissent dans le résultat. Si l'année comporte moins de quatre chiffres, le nombre est rempli à l'aide de zéros non significatifs pour atteindre quatre chiffres.

Notez que pour le calendrier bouddhiste thaïlandais, qui peut comporter des années à cinq chiffres, ce spécificateur de format inclut les cinq 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

yyyyy (plus n'importe quel nombre de spécificateurs y supplémentaires)

Représente l'année sous la forme d'un nombre à cinq chiffres. Si l'année comporte plus de cinq chiffres, seuls les cinq chiffres de poids faible apparaissent dans le résultat. Si l'année comporte moins de cinq chiffres, le nombre est rempli à l'aide de zéros non significatifs pour atteindre cinq chiffres.

S'il existe des spécificateurs y supplémentaires, le nombre est rempli à l'aide d'autant de zéros non significatifs que nécessaire pour atteindre le nombre de y spécificateurs.

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

z

Avec les valeurs DateTime, représente l'offset signé du fuseau horaire du système d'exploitation local par rapport au temps universel coordonné, en heures. Il ne reflète pas la valeur de la propriété Kind d'une instance. Par conséquent, il n'est pas recommandé d'utiliser le spécificateur de format z avec les valeurs DateTime.

Avec les valeurs DateTimeOffset, 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 situées avant l'heure UTC et un signe moins (-) les heures après l'heure UTC. L'offset peut aller de -12 à +13. Un offset à un seul chiffre est mis en forme sans zéro non significatif. Pour plus d'informations sur l'utilisation d'un spécificateur de format unique, consultez Utilisation de spécificateurs de format personnalisés uniques. 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

zz

Avec les valeurs DateTime, représente l'offset signé du fuseau horaire du système d'exploitation local par rapport à l'heure UTC, en heures. Il ne reflète pas la valeur de la propriété Kind d'une instance. Par conséquent, il n'est pas recommandé d'utiliser le spécificateur de format zz avec les valeurs DateTime.

Avec les valeurs DateTimeOffset, 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 situées avant l'heure UTC et un signe moins (-) les heures après l'heure UTC. L'offset varie de -12 à +13. 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

zzz, zzz (plus n'importe quel nombre de spécificateurs z supplémentaires)

Avec les valeurs DateTime, représente l'offset signé du fuseau horaire du système d'exploitation local par rapport à l'heure UTC, en heures et minutes. Il ne reflète pas la valeur de la propriété Kind d'une instance. Par conséquent, il n'est pas recommandé d'utiliser le spécificateur de format zzz avec les valeurs DateTime.

Avec les valeurs DateTimeOffset, représente l'offset de la valeur DateTimeOffset par rapport à l'heure UTC, en heures et minutes.

L'offset est toujours affiché avec un signe de début. Un signe plus (+) indique les heures situées avant l'heure UTC et un signe moins (-) les heures après l'heure UTC. L'offset varie de -12 à +13. 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

:

Représente le séparateur d'heure défini dans la propriété DateTimeFormatInfo.TimeSeparator en cours. Ce séparateur est utilisé pour différencier les heures, les minutes et les secondes.

/

Représente le séparateur de date défini dans la propriété DateTimeFormatInfo.DateSeparator en cours. Ce séparateur est utilisé pour différencier les années, les mois et les jours.

"

Représente une chaîne entre guillemets (guillemet). Affiche la valeur littérale de n'importe quelle chaîne entre guillemets ("). Votre application doit faire précéder chaque guillemet d'un caractère d'échappement (\).

'

Représente une chaîne entre guillemets (apostrophe). Affiche la valeur littérale de n'importe quelle chaîne entre deux apostrophes (').

%c

Représente le résultat associé à un spécificateur de format personnalisé c lorsque la chaîne de format de date et d'heure personnalisée se compose uniquement de ce spécificateur de format personnalisé. Autrement dit, pour utiliser le spécificateur de format personnalisé d, f, F, h, m, s, t, y, z, H ou M seul, l'application doit spécifier %d, %f, %F, %h, %m, %s, %t, %y, %z, %H ou %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.

\c

Représente le caractère d'échappement et affiche le caractère "c" sous la forme d'un littéral lorsque ce caractère est précédé du caractère d'échappement (\). Pour insérer le caractère barre oblique inverse dans la chaîne résultante, l'application doit utiliser deux caractères d'échappement ("\\").

N'importe quel autre caractère

Copie tout autre caractère dans la chaîne résultante sans affecter la mise en forme.

Paramètres du panneau de configuration

Les options régionales et linguistiques du Panneau de configuration influencent la chaîne résultante 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 utilisant des paramètres différents génèrent des chaînes résultantes différentes.

De plus, si le constructeur CultureInfo.CultureInfo(String) est utilisé 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 dans le Panneau de configuration seront appliquées au nouvel objet CultureInfo. La méthode CreateSpecificCulture peut être utilisée 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 en cours, qui est fourni implicitement par la culture du thread en cours ou explicitement par le paramètre IFormatProvider de la méthode qui appelle la mise en forme. Pour le paramètre IFormatProvider, votre application doit spécifier un objet CultureInfo, qui représente une culture, ou un objet DateTimeFormatInfo.

La chaîne résultante produite par la plupart des spécificateurs de format de date et d'heure personnalisés dépend des propriétés de l'objet DateTimeFormatInfo en cours. Votre application peut modifier le résultat produit par certains spécificateurs de format de date et d'heure personnalisés en modifiant la propriété DateTimeFormatInfo correspondante. Par exemple, le spécificateur de format ddd ajoute à la chaîne résultante le nom abrégé d'un jour de la semaine recherché dans le tableau de chaînes AbbreviatedDayNames. De la même façon, le spécificateur de format MMMM ajoute à la chaîne résultante un nom de mois complet recherché dans le tableau de chaînes MonthNames.

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. Par exemple, si la chaîne de format se compose uniquement du spécificateur h, elle est interprétée comme un spécificateur 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'heurestandard h.

Pour utiliser un spécificateur de format de date et d'heure personnalisé unique, incluez un espace avant ou après le spécificateur de date et d'heure ou incluez un spécificateur de format pourcentage (%) avant le spécificateur de date et d'heure personnalisé unique. Par exemple, les chaînes de format "h " et "%h" sont interprétées comme des chaînes de format de date et d'heure personnalisées qui affichent l'heure représentée par la valeur de date et d'heure en cours. Notez que si un espace est utilisé, il apparaît comme un caractère littéral dans la chaîne résultante.

Voir aussi

Concepts

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

Référence

System.DateTime

System.IFormatProvider

Autres ressources

Mise en forme des types