DatePicker.YearFormat Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Obtient ou définit le format d’affichage de la valeur de l’année.

public:
 property Platform::String ^ YearFormat { Platform::String ^ get(); void set(Platform::String ^ value); };

winrt::hstring YearFormat();

void YearFormat(winrt::hstring value);

public string YearFormat { get; set; }

var string = datePicker.yearFormat;
datePicker.yearFormat = string;

Public Property YearFormat As String

<DatePicker YearFormat="formatString"/>

Valeur de propriété

String

Platform::String

winrt::hstring

Format d’affichage de la valeur de l’année.

Exemples

Voici un DatePicker mis en forme à l’aide de modèles de format et un DatePicker mis en forme à l’aide de chaînes de format. Les deux DatePickersont identiques lorsque l’application est exécutée, car la mise en forme est équivalente.

<!-- DatePicker formatted using format templates. -->
<DatePicker DayFormat="day" MonthFormat="month.numeric" YearFormat="year.abbreviated"/>

<!-- DatePicker formatted using format patterns. -->
<DatePicker DayFormat="{}{day.integer}" MonthFormat="{}{month.integer}" YearFormat="{}{year.abbreviated}"/>

Remarques

Modifiez le format du sélecteur d’année en définissant la YearFormat propriété .

Le contenu de chaîne de chaque comboBox dans DatePicker est créé par un DateTimeFormatter. Vous indiquez à DateTimeFormatter comment mettre en forme la valeur de l’année en fournissant une chaîne qui est un modèle de format ou un modèle de format. Les modèles et modèles courants pour les valeurs d’année sont répertoriés dans le tableau suivant.

modèle de format	modèle de format
'{year.full} | {year.abbreviated} | {year.abbreviated(n)}'	'year | year.full | year.abbreviated'
'{era.full} | {era.abbreviated} | {era.abbreviated(n)}'	n/a

Notes

« Era » s’applique uniquement lorsque CalendarIdentifier est défini sur le calendrier japonais. Pour le calendrier japonais, l’ère est affichée dans le sélecteur d’année.

Pour obtenir la liste complète des modèles de format et des modèles de format, consultez la section Remarques de la documentation de la classe DateTimeFormatter .

Notes

Certains formats de date doivent être évités si le sélecteur de dates peut être affiché dans une petite zone, par exemple en ajoutant la valeur de chaîne complète du jour de la semaine. Ces chaînes peuvent être longues et peuvent être coupées si la largeur du DatePicker est contrainte d’être petite.

Voir aussi

• DayFormat
• MonthFormat
• YearVisible
• DateTimeFormatter
• Sélecteur de dates