Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

DateTimeFormatInfo, classe

Définit la manière dont un format est appliqué aux valeurs DateTime et la manière dont elles sont affichées en fonction de la culture.

System.Object
  System.Globalization.DateTimeFormatInfo

Espace de noms :  System.Globalization
Assembly :  mscorlib (dans mscorlib.dll)
[SerializableAttribute]
[ComVisibleAttribute(true)]
public sealed class DateTimeFormatInfo : ICloneable, 
	IFormatProvider

Le type DateTimeFormatInfo expose les membres suivants.

  Nom Description
Méthode publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif DateTimeFormatInfo Initialise une nouvelle instance accessible en écriture de la classe DateTimeFormatInfo qui est indépendante de la culture (dite indifférente).
Début
  Nom Description
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif AbbreviatedDayNames Obtient ou définit un tableau unidimensionnel de type String contenant les noms abrégés spécifiques à la culture des jours de la semaine.
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif AbbreviatedMonthGenitiveNames Obtient ou définit un tableau de chaînes des noms de mois abrégés associés à l'objet DateTimeFormatInfo en cours.
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif AbbreviatedMonthNames Obtient ou définit un tableau unidimensionnel de type String contenant les noms abrégés spécifiques à la culture des mois.
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif AMDesignator Obtient ou définit l'indicateur de chaîne pour les heures du matin (avant midi).
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif Calendar Obtient ou définit le calendrier à utiliser pour la culture en cours.
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif CalendarWeekRule Obtient ou définit une valeur qui spécifie la règle à utiliser pour déterminer la première semaine du calendrier de l'année.
Propriété publique Membre statique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif CurrentInfo Obtient un objet DateTimeFormatInfo en lecture seule qui met en forme les valeurs en fonction de la culture en cours.
Propriété publique Pris en charge par XNA Framework DateSeparator Obtient ou définit la chaîne qui sépare les composants d'une date, c'est-à-dire l'année, le mois et le jour.
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif DayNames Obtient ou définit un tableau unidimensionnel de type String contenant les noms complets spécifiques à la culture des jours de la semaine.
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif FirstDayOfWeek Obtient ou définit le premier jour de la semaine.
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif FullDateTimePattern Obtient ou définit le modèle de format pour une valeur de date longue et d'heure complète, associé au modèle de format "F".
Propriété publique Membre statique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif InvariantInfo Obtient le DateTimeFormatInfo en lecture seule par défaut indépendant de la culture (dite indifférente).
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif IsReadOnly Obtient une valeur indiquant si l'objet DateTimeFormatInfo est en lecture seule.
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif LongDatePattern Obtient ou définit la chaîne de format personnalisée associée à la chaîne de format standard "D" pour une valeur de date longue.
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif LongTimePattern Obtient ou définit le modèle de format pour une valeur d'heure complète, associé au modèle de format "T".
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif MonthDayPattern Obtient ou définit le modèle de format pour une valeur de mois et de jour, associé aux modèles de format "m" et "M".
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif MonthGenitiveNames Obtient ou définit un tableau de chaînes des noms de mois associés à l'objet DateTimeFormatInfo en cours.
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif MonthNames Obtient ou définit un tableau unidimensionnel de type String contenant les noms complets spécifiques à la culture des mois.
Propriété publique NativeCalendarName Obtient le nom natif du calendrier associé à l'objet DateTimeFormatInfo en cours.
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif PMDesignator Obtient ou définit l'indicateur de chaîne pour les heures de l'après-midi.
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif RFC1123Pattern Obtient le modèle de format pour une valeur d'heure, basé sur la spécification de la RFC (Request for Comments) 1123 de l'IETF (Internet Engineering Task Force) et associé aux modèles de format "r" et "R".
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif ShortDatePattern Obtient ou définit le modèle de format pour une valeur de date courte, associé au modèle de format "d".
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif ShortestDayNames Obtient ou définit un tableau de chaînes des noms de jours abrégés uniques les plus courts associés à l'objet DateTimeFormatInfo en cours.
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif ShortTimePattern Obtient ou définit le modèle de format pour une valeur d'heure abrégée, associé au modèle de format "t".
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif SortableDateTimePattern Obtient le modèle de format pour une valeur de date et d'heure pouvant être triée, associé au modèle de format "s".
Propriété publique Pris en charge par XNA Framework TimeSeparator Obtient ou définit la chaîne qui sépare les composants de l'heure, c'est-à-dire l'heure, les minutes et les secondes.
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif UniversalSortableDateTimePattern Obtient le modèle de format pour une valeur de date et d'heure universelle pouvant être triée, associé au modèle de format "u".
Propriété publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif YearMonthPattern Obtient ou définit le modèle de format pour une valeur d'année et de mois, associé aux modèles de format "y" et "Y".
Début
  Nom Description
Méthode publique Pris en charge par XNA Framework Clone Crée une copie superficielle de DateTimeFormatInfo.
Méthode publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif GetAbbreviatedDayName Retourne le nom abrégé spécifique à la culture du jour de la semaine spécifié en fonction de la culture associée à l'objet DateTimeFormatInfo en cours.
Méthode publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif GetAbbreviatedEraName Retourne une chaîne contenant le nom abrégé de l'ère spécifiée, si une abréviation existe.
Méthode publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif GetAbbreviatedMonthName Retourne le nom abrégé spécifique à la culture du mois spécifié en fonction de la culture associée à l'objet DateTimeFormatInfo en cours.
Méthode publique Pris en charge par XNA Framework GetAllDateTimePatterns() Retourne tous les modèles standard selon lesquels un format peut être appliqué aux valeurs date et heure.
Méthode publique Pris en charge par XNA Framework GetAllDateTimePatterns(Char) Retourne tous les modèles dans lesquels les valeurs date et heure peuvent être mises en forme en utilisant la chaîne de format standard.
Méthode publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif GetDayName Retourne le nom complet spécifique à la culture du jour de la semaine spécifié en fonction de la culture associée à l'objet DateTimeFormatInfo en cours.
Méthode publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif GetEra Retourne l'entier représentant l'ère spécifiée.
Méthode publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif GetEraName Retourne la chaîne contenant le nom de l'ère spécifiée.
Méthode publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif GetFormat Retourne un objet du type spécifié qui fournit un service de mise en forme DateTime.
Méthode publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique Membre statique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif GetInstance Retourne l'objet DateTimeFormatInfo associé au IFormatProvider spécifié.
Méthode publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif GetMonthName Retourne le nom complet spécifique à la culture du mois spécifié en fonction de la culture associée à l'objet DateTimeFormatInfo en cours.
Méthode publique GetShortestDayName Obtient le nom de jour abrégé le plus court pour un jour de la semaine spécifié associé à l'objet DateTimeFormatInfo en cours.
Méthode publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégée Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publique Membre statique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif ReadOnly Retourne un wrapper DateTimeFormatInfo en lecture seule.
Méthode publique SetAllDateTimePatterns Définit les chaînes de format personnalisé des date et heure qui correspondent à une chaîne de format standard spécifiée.
Méthode publique Pris en charge par XNA Framework c6dw49cz.PortableClassLibrary(fr-fr,VS.100).gif ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Début

Cette classe contient des informations, telles que les modèles de date, les modèles d'heure et les indicateurs AM/PM. Un format est appliqué aux valeurs DateTime en utilisant des modèles standard ou personnalisés dans les propriétés d'un objet DateTimeFormatInfo.

L'utilisation du constructeur DateTimeFormatInfo directement dans votre application crée uniquement des informations de date/heure pour la culture indifférente. L'application utilise la propriété InvariantInfo pour une version en lecture seule ou le constructeur DateTimeFormatInfo pour une version accessible en écriture. Il n'est pas possible de créer un objet DateTimeFormatInfo pour une culture neutre.

Pour créer un objet DateTimeFormatInfo pour une culture spécifique, l'application crée un objet CultureInfo pour cette culture et récupère la propriété CultureInfo.DateTimeFormat. Les données date/heure obtenues de cette façon sont uniquement applicables à la culture spécifique.

Pour créer un objet DateTimeFormatInfo pour la culture du thread actuel, l'application doit utiliser la propriété CurrentInfo.

L'utilisateur peut choisir de substituer certaines des valeurs associées à la culture Windows en cours par le biais des options régionales et linguistiques du Panneau de configuration. Ainsi, il peut modifier le format d'affichage des dates ou utiliser une devise autre que la devise par défaut de la culture. Si la propriété CultureInfo.UseUserOverride a la valeur true, les propriétés de l'objet CultureInfo.DateTimeFormat, de l'objet CultureInfo.NumberFormat et de l'objet CultureInfo.TextInfo sont aussi récupérées à partir des paramètres utilisateur. Si les paramètres utilisateur ne sont pas compatibles avec la culture associée à l'objet CultureInfo par exemple, si le calendrier sélectionné n'est pas l'un des calendriers indiqués par OptionalCalendars, les résultats des méthodes et les valeurs des propriétés ne sont pas définis.

Pour les versions de .NET Framework antérieures à la version 2.0, si la propriété CultureInfo.UseUserOverride a la valeur true, l'objet lit chaque propriété substituable par l'utilisateur uniquement lors du premier accès à cette dernière. Étant donné que DateTimeFormatInfo a plusieurs propriétés substituables par l'utilisateur, cette « initialisation paresseuse » peut mener à une incohérence entre de telles propriétés lorsque l'application accède à une propriété, l'utilisateur change de culture ou substitue des propriétés de la culture actuelle de l'utilisateur, puis l'application accède ensuite à une autre propriété. Par exemple, dans une séquence comme celle-ci, il est possible d'accéder à LongDatePattern. L'utilisateur peut modifier ensuite des modèles dans le Panneau de configuration. Lors d'un accès à ShortDatePattern, celui-ci suit les nouveaux paramètres. Des incohérences similaires se produisent lorsque l'utilisateur choisit une culture d'utilisateur différente, plutôt que de simplement substituer un modèle particulier.

Dans le .NET Framework version 2.0 et ultérieures, DateTimeFormatInfo n'utilise pas cette « initialisation tardive ». À la place, il lit toutes les propriétés substituables par l'utilisateur lors de leur création. Il reste une petite fenêtre de vulnérabilité puisque ni la création d'objet ni le processus de substitution par l'utilisateur n'est atomique et les valeurs pertinentes peuvent changer au milieu d'une création d'objet. Toutefois, cette éventualité reste extrêmement rare.

Cette modification est particulièrement importante dans le cas de la sérialisation. Le .NET Framework version 2.0 et ultérieures rend persistants tous les paramètres substituables et pas seulement ceux qui font l'objet d'un accès au moment de la sérialisation.

L'application peut remplacer les modèles standard par des modèles personnalisés en définissant les propriétés associées d'un objet DateTimeFormatInfo accessible en écriture. Pour déterminer si un objet DateTimeFormatInfo est accessible en écriture, l'application doit utiliser la propriété IsReadOnly.

La table suivante répertorie les modèles de format DateTime standard associés aux propriétés DateTimeFormatInfo. Pour plus d'informations, consultez Chaînes de format de date et d'heure standard.

Modèle de format

Propriété associée / description

d

ShortDatePattern

D

LongDatePattern

f

Date et heure complètes (date longue et heure abrégée)

F

FullDateTimePattern (date longue et heure complète)

g

Général (date courte et heure abrégée)

G

Général (date courte et heure complète)

m, M

MonthDayPattern

o, O

Modèle de date/heure aller-retour ; avec ce modèle de format, l'opération de mise en forme ou d'analyse utilise toujours la culture indifférente

r, R

RFC1123Pattern ; avec ce modèle de format, l'opération de mise en forme ou d'analyse utilise toujours la culture indifférente

s

SortableDateTimePattern (basé sur ISO 8601) en utilisant l'heure locale ; avec ce modèle de format, l'opération de mise en forme ou d'analyse utilise toujours la culture indifférente

t

ShortTimePattern

T

LongTimePattern

u

UniversalSortableDateTimePattern à l'aide du format d'affichage du temps universel ; avec ce modèle de format, l'opération de mise en forme ou d'analyse utilise toujours la culture indifférente

U

Date et heure complètes (date longue et heure complète) en utilisant le temps universel

y, Y

YearMonthPattern

Le tableau suivant répertorie les modèles de format DateTime personnalisés et leur comportement. Pour plus d'informations, consultez Chaînes de format de date et d'heure personnalisées.

Modèle de format

Description

d, %d

Jour du mois. Un zéro non significatif n'est pas ajouté devant les jours à un chiffre. L'application spécifie "%d" si le modèle de format n'est pas combiné avec d'autres modèles de format.

dd

Jour du mois. Un zéro non significatif est ajouté devant les jours à un chiffre.

ddd

Nom abrégé du jour de la semaine, comme défini dans AbbreviatedDayNames.

dddd

Nom complet du jour de la semaine, comme défini dans DayNames.

f, %f

Fraction d'une seconde à un chiffre. Les chiffres restants sont tronqués. L'application spécifie "%f" si le modèle de format n'est pas combiné avec d'autres modèles de format.

ff

Fraction d'une seconde à deux chiffres. Les chiffres restants sont tronqués.

fff

Fraction d'une seconde à trois chiffres. Les chiffres restants sont tronqués.

ffff

Fraction d'une seconde à quatre chiffres. Les chiffres restants sont tronqués.

fffff

Fraction d'une seconde à cinq chiffres. Les chiffres restants sont tronqués.

ffffff

Fraction d'une seconde à six chiffres. Les chiffres restants sont tronqués.

fffffff

Fraction d'une seconde à sept chiffres. Les chiffres restants sont tronqués.

F, %F

Affiche le chiffre le plus significatif de la fraction de seconde. Rien ne s'affiche si le chiffre est zéro. L'application spécifie "%F" si le modèle de format n'est pas combiné avec d'autres modèles de format.

FF

Affiche les deux chiffres les plus significatifs de la fraction de seconde. Toutefois, les zéros de fin, ou deux chiffres zéro, ne sont pas affichés.

FFF

Affiche les trois chiffres les plus significatifs de la fraction de seconde. Toutefois, les zéros de fin, ou trois chiffres zéro, ne sont pas affichés.

FFFF

Affiche les quatre chiffres les plus significatifs de la fraction de seconde. Toutefois, les zéros de fin, ou quatre chiffres zéro, ne sont pas affichés.

FFFFF

Affiche les cinq chiffres les plus significatifs de la fraction de seconde. Toutefois, les zéros de fin, ou cinq chiffres zéro, ne sont pas affichés.

FFFFFF

Affiche les six chiffres les plus significatifs de la fraction de seconde. Toutefois, les zéros de fin, ou six chiffres zéro, ne sont pas affichés.

FFFFFFF

Affiche les sept chiffres les plus significatifs de la fraction de seconde. Toutefois, les zéros de fin, ou sept chiffres zéro, ne sont pas affichés.

gg

Période ou ère. Ce modèle est ignoré si la date à laquelle appliquer un format ne possède pas de chaîne de période ou d'ère associée.

h, %h

Heure au format 12 heures. Les heures à un seul chiffre ne sont pas précédées d'un zéro non significatif. L'application spécifie "%h" si le modèle de format n'est pas combiné avec d'autres modèles de format.

hh

Heure au format 12 heures. Les heures à un seul chiffre sont précédées d'un zéro non significatif.

H, %H

Heure au format 24 heures. Les heures à un seul chiffre ne sont pas précédées d'un zéro non significatif. L'application spécifie "%H" si le modèle de format n'est pas combiné avec d'autres modèles de format.

HH

Heure au format 24 heures. Les heures à un seul chiffre sont précédées d'un zéro non significatif.

K

Différentes valeurs de la propriété Kind, c'est-à-dire Local, Utc Unspecified.

m, %m

Minute. Un zéro non significatif n'est pas ajouté aux minutes à un chiffre. L'application spécifie "%m" si le modèle de format n'est pas combiné avec d'autres modèles de format.

mm

Minute. Les minutes à un seul chiffre sont précédées d'un zéro non significatif.

M, %M

Mois en chiffres. Un zéro non significatif n'est pas ajouté devant les mois à un chiffre. L'application spécifie "%M" si le modèle de format n'est pas combiné avec d'autres modèles de format.

MM

Mois en chiffres. Les numéros de mois à un seul chiffre sont précédés d'un zéro.

MMM

Nom abrégé du mois, comme défini dans AbbreviatedMonthNames.

MMMM

Nom complet du mois, comme défini dans MonthNames.

s, %s

Seconde. Un zéro non significatif n'est pas ajouté devant les secondes à un chiffre. L'application spécifie "%s" si le modèle de format n'est pas combiné avec d'autres modèles de format.

ss

Seconde. Les secondes à un seul chiffre sont précédées d'un zéro non significatif.

t, %t

Premier caractère de l'indicateur AM/PM défini dans AMDesignator ou PMDesignator, le cas échéant. L'application spécifie "%t" si le modèle de format n'est pas combiné avec d'autres modèles de format.

tt

Indicateur AM/PM défini dans AMDesignator ou PMDesignator, le cas échéant. Votre application doit utiliser ce modèle de format 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.

y, %y

Année sans le siècle. Si l'année sans le siècle est inférieure à dix, l'année est affichée sans zéro non significatif. L'application spécifie "%y" si le modèle de format n'est pas combiné avec d'autres modèles de format.

yy

Année sans le siècle. Si l'année sans le siècle est inférieure à dix, l'année est affichée avec un zéro non significatif.

yyy

Année à trois chiffres. Si l'année est inférieure 100, elle est affichée avec un zéro non significatif.

yyyy

Année à quatre ou cinq chiffres (selon le calendrier utilisé), y compris le siècle. Remplit avec des zéros non significatifs pour obtenir quatre chiffres. Les calendriers thaï bouddhiste et coréen ont des années à cinq chiffres. Les utilisateurs qui sélectionnent le modèle "yyyy" verront les cinq chiffres sans zéros non significatifs pour les calendriers qui ont cinq chiffres. Exception : les calendriers japonais et taïwanais se comportent toujours comme si "yy" est sélectionné.

yyyyy

Année à cinq chiffres. Remplit avec des zéros non significatifs pour obtenir cinq chiffres. Exception : les calendriers japonais et taïwanais se comportent toujours comme si "yy" est sélectionné.

yyyyyy

Année à six chiffres. Remplit avec des zéros non significatifs pour obtenir six chiffres. Exception : les calendriers japonais et taïwanais se comportent toujours comme si "yy" est sélectionné. Le modèle peut être poursuivi avec une chaîne plus longue de "y" remplie avec d'autres zéros non significatifs.

z, %z

Décalage horaire (signe « + » ou « - » suivi de l'heure uniquement). Les heures à un seul chiffre ne sont pas précédées d'un zéro non significatif. Par exemple, l'heure du Pacifique (PST, Pacific Standard Time) est « -8 ». L'application spécifie "%z" si le modèle de format n'est pas combiné avec d'autres modèles de format.

zz

Décalage horaire (signe « + » ou « - » suivi de l'heure uniquement). Les heures à un seul chiffre sont précédées d'un zéro non significatif. Par exemple, l'heure du Pacifique (PST, Pacific Standard Time) est « -08 ».

zzz

Décalage horaire (signe « + » ou « - » suivi de l'heure et des minutes). Un zéro non significatif n'est pas ajouté devant les heures et les minutes à un chiffre. Par exemple, l'heure du Pacifique (PST, Pacific Standard Time) est « -08:00 ».

:

Séparateur horaire par défaut défini dans TimeSeparator.

/

Séparateur de date par défaut défini dans DateSeparator.

% c

c est un modèle de format s'il est utilisé seul. Pour utiliser le modèle de format "d", "f", "F", "h", "m", "s", "t", "y", "z", "H" ou "M" seul, l'application spécifie "%d", "%f", "%F", "%h", "%m", "%s", "%t", "%y", "%z", "%H" ou "%M".

Le caractère "%" peut être omis si le modèle de format est combiné avec des caractères de type littéral ou d'autres modèles de format.

\ c

c est n'importe quel caractère. Affiche le caractère littéralement. Pour afficher la barre oblique inverse, l'application doit utiliser "\\."

Seuls les modèles de format répertoriés dans le second tableau ci-dessus peuvent être utilisés pour créer des modèles personnalisés. Les modèles de format standard répertoriés dans le premier tableau sont utilisés uniquement pour créer des modèles standard. Les modèles personnalisés possèdent au moins deux caractères; par exemple :

  • DateTime.ToString("d") retourne la valeur DateTime ; "d" est le modèle de date courte standard.

  • DateTime.ToString("%d") retourne le jour du mois ; "%d" est un modèle personnalisé.

  • DateTime.ToString("d ") retourne le jour du mois suivi d'un espace d'espace blanc ; "d " est un modèle personnalisé.

L'application peut créer un objet DateTimeFormatInfo ou un objet NumberFormatInfo uniquement pour la culture dite indifférente ou pour des cultures spécifiques et non pour des cultures neutres. Pour plus d'informations sur la culture dite indifférente, les cultures spécifiques et les cultures neutres, consultez la classe CultureInfo.

Cette classe implémente l'interface ICloneable pour activer la duplication d'objets DateTimeFormatInfo. Elle implémente aussi IFormatProvider pour fournir les informations de mise en forme aux applications.

L'exemple de code suivant affiche les différents modèles de formats de la culture en-US. Il affiche également la valeur des propriétés associées aux modèles de format.


using System;
using System.Globalization;


public class SamplesDTFI  {

   public static void Main()  {

      // Creates and initializes a DateTimeFormatInfo associated with the en-US culture.
      DateTimeFormatInfo myDTFI = new CultureInfo( "en-US", false ).DateTimeFormat;

      // Creates a DateTime with the Gregorian date January 3, 2002 (year=2002, month=1, day=3).
      // The Gregorian calendar is the default calendar for the en-US culture.
      DateTime myDT = new DateTime( 2002, 1, 3 );

      // Displays the format pattern associated with each format character.
      Console.WriteLine( "FORMAT  en-US EXAMPLE" );
      Console.WriteLine( "CHAR    VALUE OF ASSOCIATED PROPERTY, IF ANY\n" );
      Console.WriteLine( "  d     {0}", myDT.ToString("d", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.ShortDatePattern, "(ShortDatePattern)" );
      Console.WriteLine( "  D     {0}", myDT.ToString("D", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.LongDatePattern, "(LongDatePattern)" );
      Console.WriteLine( "  f     {0}\n", myDT.ToString("f", myDTFI) );
      Console.WriteLine( "  F     {0}", myDT.ToString("F", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.FullDateTimePattern, "(FullDateTimePattern)" );
      Console.WriteLine( "  g     {0}\n", myDT.ToString("g", myDTFI) );
      Console.WriteLine( "  G     {0}\n", myDT.ToString("G", myDTFI) );
      Console.WriteLine( "  m     {0}", myDT.ToString("m", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.MonthDayPattern, "(MonthDayPattern)" );
      Console.WriteLine( "  M     {0}", myDT.ToString("M", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.MonthDayPattern, "(MonthDayPattern)" );
      Console.WriteLine( "  o     {0}\n", myDT.ToString("o", myDTFI) );
      Console.WriteLine( "  r     {0}", myDT.ToString("r", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.RFC1123Pattern, "(RFC1123Pattern)" );
      Console.WriteLine( "  R     {0}", myDT.ToString("R", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.RFC1123Pattern, "(RFC1123Pattern)" );
      Console.WriteLine( "  s     {0}", myDT.ToString("s", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.SortableDateTimePattern, "(SortableDateTimePattern)" );
      Console.WriteLine( "  t     {0}", myDT.ToString("t", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.ShortTimePattern, "(ShortTimePattern)" );
      Console.WriteLine( "  T     {0}", myDT.ToString("T", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.LongTimePattern, "(LongTimePattern)" );
      Console.WriteLine( "  u     {0}", myDT.ToString("u", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.UniversalSortableDateTimePattern, "(UniversalSortableDateTimePattern)" );
      Console.WriteLine( "  U     {0}\n", myDT.ToString("U", myDTFI) );
      Console.WriteLine( "  y     {0}", myDT.ToString("y", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.YearMonthPattern, "(YearMonthPattern)" );
      Console.WriteLine( "  Y     {0}", myDT.ToString("Y", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.YearMonthPattern, "(YearMonthPattern)" );

   }

}

/*
This code produces the following output.

FORMAT  en-US EXAMPLE
CHAR    VALUE OF ASSOCIATED PROPERTY, IF ANY

  d     1/3/2002
        M/d/yyyy (ShortDatePattern)

  D     Thursday, January 03, 2002
        dddd, MMMM dd, yyyy (LongDatePattern)

  f     Thursday, January 03, 2002 12:00 AM

  F     Thursday, January 03, 2002 12:00:00 AM
        dddd, MMMM dd, yyyy h:mm:ss tt (FullDateTimePattern)

  g     1/3/2002 12:00 AM

  G     1/3/2002 12:00:00 AM

  m     January 03
        MMMM dd (MonthDayPattern)

  M     January 03
        MMMM dd (MonthDayPattern)

  o     2002-01-03T00:00:00.0000000

  r     Thu, 03 Jan 2002 00:00:00 GMT
        ddd, dd MMM yyyy HH':'mm':'ss 'GMT' (RFC1123Pattern)

  R     Thu, 03 Jan 2002 00:00:00 GMT
        ddd, dd MMM yyyy HH':'mm':'ss 'GMT' (RFC1123Pattern)

  s     2002-01-03T00:00:00
        yyyy'-'MM'-'dd'T'HH':'mm':'ss (SortableDateTimePattern)

  t     12:00 AM
        h:mm tt (ShortTimePattern)

  T     12:00:00 AM
        h:mm:ss tt (LongTimePattern)

  u     2002-01-03 00:00:00Z
        yyyy'-'MM'-'dd HH':'mm':'ss'Z' (UniversalSortableDateTimePattern)

  U     Thursday, January 03, 2002 8:00:00 AM

  y     January, 2002
        MMMM, yyyy (YearMonthPattern)

  Y     January, 2002
        MMMM, yyyy (YearMonthPattern)

*/


.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Pris en charge dans :

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ