DateTimeFormatter Class

Met en forme les dates et heures.

Syntaxe


var dateTimeFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter(string);
var dateTimeFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter(string, iIterable(String));
var dateTimeFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter(string, iIterable(String));
var dateTimeFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter(yearFormat, monthFormat, dayFormat, dayOfWeekFormat);
var dateTimeFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter(hourFormat, minuteFormat, secondFormat);
var dateTimeFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter(yearFormat, monthFormat, dayFormat, dayOfWeekFormat, hourFormat, minuteFormat, secondFormat, iIterable(String));
var dateTimeFormatter = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter(yearFormat, monthFormat, dayFormat, dayOfWeekFormat, hourFormat, minuteFormat, secondFormat, iIterable(String));

Attributs

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

Membres

DateTimeFormatterClasse possède ces types de membres :

Constructeurs

DateTimeFormatterClasse possède ces constructeurs.

ConstructeurDescription
DateTimeFormatter(HourFormat, MinuteFormat, SecondFormat) Creates a DateTimeFormatter object that is initialized with hour, minute, and second formats.
DateTimeFormatter(String) Creates a DateTimeFormatter object that is initialized by a format template string.
DateTimeFormatter(String, IIterable(String)) Creates a DateTimeFormatter object that is initialized by a format template string and language list.
DateTimeFormatter(String, IIterable(String), String, String, String) Creates a DateTimeFormatter object that is initialized by a format template string, language list, geographic region, calendar, and clock.
DateTimeFormatter(YearFormat, MonthFormat, DayFormat, DayOfWeekFormat) Creates a DateTimeFormatter object that is initialized with year, month, day, and day of week formats.
DateTimeFormatter(YearFormat, MonthFormat, DayFormat, DayOfWeekFormat, HourFormat, MinuteFormat, SecondFormat, IIterable(String)) Creates a DateTimeFormatter object that is initialized with year, month, day, day of week, hour, minute, and second formats, and a language list.
DateTimeFormatter(YearFormat, MonthFormat, DayFormat, DayOfWeekFormat, HourFormat, MinuteFormat, SecondFormat, IIterable(String), String, String, String) Creates a DateTimeFormatter object with all formats and identifiers specified.

 

Méthodes

The DateTimeFormatter Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
Format(DateTime) Returns a string representation of the provided date and time.
Format(DateTime, String) Returns a string that represents the given date and time in the given time zone, conforming to the template the formatter is currently using.

 

Propriétés

Le DateTimeFormatterClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

Calendar

En lecture seuleGets the calendar that is used when formatting dates.

Clock

En lecture seuleGets the clock that is used when formatting times.

GeographicRegion

En lecture seuleGets or sets the region that is used when formatting dates and times.

IncludeDay

En lecture seuleGets the DayFormat in the template.

IncludeDayOfWeek

En lecture seuleGets the DayOfWeekFormat in the template.

IncludeHour

En lecture seuleGets the HourFormat in the template.

IncludeMinute

En lecture seuleGets the MinuteFormat in the template.

IncludeMonth

En lecture seuleGets the MonthFormat in the template.

IncludeSecond

En lecture seuleGets the SecondFormat in the template.

IncludeYear

En lecture seuleGets the YearFormat in the template.

Languages

En lecture seuleGets the priority list of language identifiers that is used when formatting dates and times.

LongDate

En lecture seuleGets the DateTimeFormatter object that formats dates according to the user's choice of long date pattern.

LongTime

En lecture seuleGets the DateTimeFormatter object that formats times according to the user's choice of long time pattern.

NumeralSystem

Lecture/écritureGets or sets the numbering system that is used to format dates and times.

Patterns

En lecture seuleGets the patterns corresponding to this template that are used when formatting dates and times.

ResolvedGeographicRegion

En lecture seuleGets the geographic region that was most recently used to format dates and times.

ResolvedLanguage

En lecture seuleGets the language that was most recently used to format dates and times.

ShortDate

En lecture seuleGets the DateTimeFormatter object that formats dates according to the user's choice of short date pattern.

ShortTime

En lecture seuleGets the DateTimeFormatter object that formats times according to the user's choice of short time pattern.

Template

En lecture seuleGets a string representation of this format template.

 

Remarques

Remarque  Si votre application passe les balises de langue utilisées cette classe aux fonctions NLS (National Language Support), elle doit d'abord convertir les balises en appelant ResolveLocaleName.

Certains constructeurs pour DateTimeFormatter prennent un paramètre de chaîne formatTemplate qui spécifie les composants nécessaires à mettre en forme. Ce paramètre peut être un modèle de format ou un schéma de format.

Les Modèles de format sont des chaînes qui spécifient les modèles courants de date et d'heure. Certains modèles couramment utilisés sont répertoriés dans le tableau suivant. Dans les modèles comportant plusieurs composants, le composant peut être l'une des variations de composant prises en charge et les composants peuvent être dans n'importe quel ordre. Par exemple, "dayofweek.full year month.numeric day" est pris en charge. (Voir ci-dessous, après les exemples, pour en savoir plus sur la grammaire qui définit des modèles valides.)

Modèle
longdate
shortdate
longtime
shorttime
dayofweek
dayofweek.full
dayofweek.abbreviated
day
month
month.full
month.abbreviated
month.numeric
year
year.full
year.abbreviated
dayofweek day month year
dayofweek day month
day month year
day month
month year
hour
minute
second
hour minute second
hour minute
fuseau horaire
timezone.full
timezone.abbreviated
year month day hour

 

Les Modèles de format sont composés d'une chaîne littérale avec des champs délimités par des accolades, par exemple "{day.numeric}/{month.numeric}/{year.full}". Certains champs couramment utilisés sont répertoriés dans le tableau suivant. (Voir ci-dessous, après les exemples, pour en savoir plus sur la grammaire qui définit des modèles valides.)

Champ de modèle de format
{openbrace}
{closebrace}
{dayofweek.solo.<type>} où <type> est complet/abrégé/abrégé(n)
{dayofweek.<type>} où <type> est complet/abrégé/abrégé(n)
{jour.<type>} où <type> est entier/entier(n)
{mois.<type>} où <type> est complet/abrégé/abrégé(n)/entier/entier(n)
{month.solo.<type>} où <type> est complet/abrégé/abrégé(n)
{year.<type>} où <type> est complet/abrégé/abrégé(n)
{era.<type>} où <type> est complet/abrégé/abrégé(n)
{hour.<type>} où <type> est entier/entier(n)
{period.<type>} où <type> est complet/abrégé/abrégé(n)
{minute.<type>} où <type> est entier/entier(n)
{second.<type>} où <type> est entier/entier(n)
{timezone.<type>} où <type> est complet/abrégé/abrégé(n)

 

Remarque  

  • Utilisez {openbrace} ou {closebrace} pour spécifier que "{" ou "}" apparaît dans la chaîne littérale.
  • solo spécifie le formulaire autonome. Pour les langages avec distinctions du cas génitif, celui-ci est le cas non marqué. Pour obtenir la forme nominative, utilisez solo.
  • integer(2) pour le cinquième jour du mois (par exemple) est "05", tandis que integer(1) produit "5". integer génère le meilleur n pour une combinaison langue/calendrier donnée.
  • Pour les années, full génère tous les chiffres ("2013"). abbreviated est synonyme de abbreviated(2), qui correspond à l'année à 2 chiffres pour le calendrier grégorien ("13"). (D'autres calendriers peuvent éventuellement utiliser une autre valeur par défaut ; nous avons conservé abbreviated pour avoir la meilleure sémantique pour une combinaison langue/calendrier donnée.) abbreviated(n) est tronqué aux chiffres n les moins significatifs (par exemple, 2013 avec n=1 est "3").

Exemples

Utilisez la classe DateTimeFormatter pour mettre en forme une date.


// Format a date via a string template. Note that the order specifed in the string pattern does
// not determine the order of the parts of the formatted string. The user's language and region
// preferences will determine the pattern of the date returned based on the specified parts.

var mydatefmt = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter("month day dayofweek year");
var dateToFormat = new Date();
var mydate = mydatefmt.format(dateToFormat);

Syntaxe de modèle

La syntaxe suivante définit ce qui est accepté pour un modèle :

<pattern> ::= [<literal-text>] <datetime-pattern> [<literal-text>] |
              [<literal-text>] <datetime-pattern> <pattern>

<literal-text> ::= <literal-character>+

<literal-character> ::= [^{}] | "{openbrace}" | "{closebrace}"

<datetime-pattern> ::= <date-pattern> | <time-pattern>

<date-pattern> ::= <era> | <year> | <month> | <day> | <dayofweek>

<time-pattern> ::= <period> | <hour> | <minute> | <second> | <timezone>

<era> ::= "{era.abbreviated" [<ideal-length>] "}"

<year> ::= "{year.full" [<ideal-length>] "}" |
           "{year.abbreviated" [<ideal-length>] "}"

<month> ::= "{month.full}" |
            "{month.solo.full}" |
            "{month.abbreviated" [<ideal-length>] "}"
            "{month.solo.abbreviated" [<ideal-length>] "}"
            "{month.integer" [<ideal-length>] "}"

<dayofweek> ::= "{dayofweek.full}" |
                "{dayofweek.solo.full}" |
                "{dayofweek.abbreviated" [<ideal-length>] "}"
                "{dayofweek.solo.abbreviated" [<ideal-length>] "}"

<day> ::= "{day.integer" [<ideal-length>] "}"

<period> ::= "{period.abbreviated" [<ideal-length>] "}"

<hour> ::= "{hour.integer" [<ideal-length>] "}"

<minute> ::= "{minute.integer" [<ideal-length>] "}"

<second> ::= "{second.integer" [<ideal-length>] "}"

<timezone> ::= "{timezone.full}" |
                "{timezone.abbreviated" [<ideal-length>] "}"

<ideal-length> ::= "(" <non-zero-digit> ")"

<non-zero-digit> ::= "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9"

Syntaxe de modèle

La syntaxe suivante définit ce qui est accepté pour un modèle :

<template> ::= <opt-whitespace> <date> <opt-whitespace> |
               <opt-whitespace> <time> <opt-whitespace> |
               <opt-whitespace> <specific-date> <whitespace> <time> <opt-whitespace> |
               <opt-whitespace> <time> <whitespace> <specific-date> <opt-whitespace> |
               <opt-whitespace> <relative-date> <whitespace> <time> <opt-whitespace> |
               <opt-whitespace> <time> <whitespace> <relative-date> <opt-whitespace>

<opt-whitespace> ::= [<whitespace>] 

<whitespace> ::= " "+ 

<date> ::= <year> | <month> | <day> | <month-year> | <relative-date> | <specific-date>

<relativedate> ::= <dayofweek> | <month-day> | <relative-longdate>

<specificdate> ::= <shortdate> | <longdate>

<month-day> ::= <month> <whitespace> <day> |
                <day> <whitespace> <month>

<relative-longdate> ::= <month> <whitespace> <day> <whitespace> <dayofweek> |
                        <month> <whitespace> <dayofweek> <whitespace> <day> |
                        <day> <whitespace> <month> <whitespace> <dayofweek> |
                        <day> <whitespace> <dayofweek> <whitespace> <month> |
                        <dayofweek> <whitespace> <day> <whitespace> <month> |
                        <dayofweek> <whitespace> <month> <whitespace> <day>

<month-year> ::= <month> <whitespace> <year> |
                 <year> <whitespace> <month>


<shortdate> ::= "shortdate" |
                <month> <whitespace> <day> <whitespace> <year> |
                <month> <whitespace> <year> <whitespace> <day> |
                <day> <whitespace> <month> <whitespace> <year> |
                <day> <whitespace> <year> <whitespace> <month> |
                <year> <whitespace> <day> <whitespace> <month> |
                <year> <whitespace> <month> <whitespace> <day>


<longdate> ::= "longdate" |
               <year> <whitespace> <month> <whitespace> <day> <whitespace> <dayofweek> |
               <year> <whitespace> <month> <whitespace> <dayofweek> <whitespace> <day> |
               <year> <whitespace> <day> <whitespace> <month> <whitespace> <dayofweek> |
               <year> <whitespace> <day> <whitespace> <dayofweek> <whitespace> <month> |
               <year> <whitespace> <dayofweek> <whitespace> <day> <whitespace> <month> |
               <year> <whitespace> <dayofweek> <whitespace> <month> <whitespace> <day> |
               <month> <whitespace> <year> <whitespace> <day> <whitespace> <dayofweek> |
               <month> <whitespace> <year> <whitespace> <dayofweek> <whitespace> <day> |
               <day> <whitespace> <year> <whitespace> <month> <whitespace> <dayofweek> |
               <day> <whitespace> <year> <whitespace> <dayofweek> <whitespace> <month> |
               <dayofweek> <whitespace> <year> <whitespace> <day> <whitespace> <month> |
               <dayofweek> <whitespace> <year> <whitespace> <month> <whitespace> <day> |
               <month> <whitespace> <day> <whitespace> <year> <whitespace> <dayofweek> |
               <month> <whitespace> <dayofweek> <whitespace> <year> <whitespace> <day> |
               <day> <whitespace> <month> <whitespace> <year> <whitespace> <dayofweek> |
               <day> <whitespace> <dayofweek> <whitespace> <year> <whitespace> <month> |
               <dayofweek> <whitespace> <day> <whitespace> <year> <whitespace> <month> |
               <dayofweek> <whitespace> <month> <whitespace> <year> <whitespace> <day> |
               <month> <whitespace> <day> <whitespace> <dayofweek> <whitespace> <year> |
               <month> <whitespace> <dayofweek> <whitespace> <day> <whitespace> <year> |
               <day> <whitespace> <month> <whitespace> <dayofweek> <whitespace> <year> |
               <day> <whitespace> <dayofweek> <whitespace> <month> <whitespace> <year> |
               <dayofweek> <whitespace> <day> <whitespace> <month> <whitespace> <year> |
               <dayofweek> <whitespace> <month> <whitespace> <day> <whitespace> <year>

<time> ::= <hour> | 
           <hour> <whitespace> <timezone> |
           <timezone> <whitespace> <hour> |
           <shorttime> |
           <longtime>

<shorttime> ::= "shorttime" |
                <hour> <whitespace> <minute> |
                <minute> <whitespace> <hour> |
                <timezone> <whitespace> <hour> <whitespace> <minute> |
                <timezone> <whitespace> <minute> <whitespace> <hour> |
                <hour> <whitespace> <timezone> <whitespace> <minute> |
                <minute> <whitespace> <timezone> <whitespace> <hour> |
                <hour> <whitespace> <minute> <whitespace> <timezone> |
                <minute> <whitespace> <hour> <whitespace> <timezone>

<longtime> ::= "longtime" |
               <hour> <whitespace> <minute> <whitespace> <second> |
               <hour> <whitespace> <second> <whitespace> <minute> |
               <minute> <whitespace> <hour> <whitespace> <second> |
               <minute> <whitespace> <second> <whitespace> <hour> |
               <second> <whitespace> <minute> <whitespace> <hour> |
               <second> <whitespace> <hour> <whitespace> <minute> |
               <timezone> <whitespace> <hour> <whitespace> <minute> <whitespace> <second> |
               <timezone> <whitespace> <hour> <whitespace> <second> <whitespace> <minute> |
               <timezone> <whitespace> <minute> <whitespace> <hour> <whitespace> <second> |
               <timezone> <whitespace> <minute> <whitespace> <second> <whitespace> <hour> |
               <timezone> <whitespace> <second> <whitespace> <minute> <whitespace> <hour> |
               <timezone> <whitespace> <second> <whitespace> <hour> <whitespace> <minute> |
               <hour> <whitespace> <timezone> <whitespace> <minute> <whitespace> <second> |
               <hour> <whitespace> <timezone> <whitespace> <second> <whitespace> <minute> |
               <minute> <whitespace> <timezone> <whitespace> <hour> <whitespace> <second> |
               <minute> <whitespace> <timezone> <whitespace> <second> <whitespace> <hour> |
               <second> <whitespace> <timezone> <whitespace> <minute> <whitespace> <hour> |
               <second> <whitespace> <timezone> <whitespace> <hour> <whitespace> <minute> |
               <hour> <whitespace> <minute> <whitespace> <timezone> <whitespace> <second> |
               <hour> <whitespace> <second> <whitespace> <timezone> <whitespace> <minute> |
               <minute> <whitespace> <hour> <whitespace> <timezone> <whitespace> <second> |
               <minute> <whitespace> <second> <whitespace> <timezone> <whitespace> <hour> |
               <second> <whitespace> <minute> <whitespace> <timezone> <whitespace> <hour> |
               <second> <whitespace> <hour> <whitespace> <timezone> <whitespace> <minute> |
               <hour> <whitespace> <minute> <whitespace> <second> <whitespace> <timezone> |
               <hour> <whitespace> <second> <whitespace> <minute> <whitespace> <timezone> |
               <minute> <whitespace> <hour> <whitespace> <second> <whitespace> <timezone> |
               <minute> <whitespace> <second> <whitespace> <hour> <whitespace> <timezone> |
               <second> <whitespace> <minute> <whitespace> <hour> <whitespace> <timezone> |
               <second> <whitespace> <hour> <whitespace> <minute> <whitespace> <timezone>

<year> ::= "year" | "year.full" | "year.abbreviated"

<month> ::= "month" | "month.full" | "month.abbreviated" | "month.numeric"

<day> ::= "day"

<dayofweek> ::= "dayofweek" | "dayofweek.full" | "dayofweek.abbreviated"

<hour> ::= "hour"

<minute> ::= "minute"

<second> ::= "second"

<timezone> ::= "timezone" | "timezone.full" | "timezone.abbreviated"

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store, applications de bureau]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store, applications de bureau]

Espace de noms

Windows.Globalization.DateTimeFormatting
Windows::Globalization::DateTimeFormatting [C++]

Métadonnées

Windows.winmd

Voir aussi

Exemple de mise en forme des dates et des heures

 

 

Afficher:
© 2014 Microsoft