DatePicker.MonthFormat Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Obtient ou définit le format d’affichage de la valeur du mois.

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

winrt::hstring MonthFormat();

void MonthFormat(winrt::hstring value);

public string MonthFormat { get; set; }

var string = datePicker.monthFormat;
datePicker.monthFormat = string;

Public Property MonthFormat As String

<DatePicker MonthFormat="formatString"/>

Valeur de propriété

String

Platform::String

winrt::hstring

Format d’affichage de la valeur du mois.

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 contrôles DatePicker se ressemblent 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}"/>

Voici un DatePicker qui combine 2 modèles de format pour afficher à la fois le numéro de mois et le nom dans le sélecteur de mois. Vous pouvez ajouter des chaînes littérales à la structure de format, par exemple les parenthèses autour de l’abréviation du mois : ({month.abbreviated}). Il n’existe aucun modèle de format équivalent pour ce format.

<DatePicker MonthFormat="{}{month.integer} ({month.abbreviated})"/>

Remarques

Modifiez le format du sélecteur de mois en définissant la MonthFormat 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 month 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 de mois sont répertoriés dans le tableau suivant.

modèle de format	modèle de format
'{month.integer} | {month.integer(n)} '	'month.numeric'
« {month.full} | {month.abbreviated} | {month.abbreviated(n)}'	'mois | month.full | month.abbreviated'

Dans certains cas, l’utilisation d’un modèle de format vous permet de contrôler plus précisément la mise en forme. Par exemple, vous pouvez utiliser un modèle de format pour spécifier que le sélecteur de mois affiche toujours 2 chiffres, y compris un premier 0 si nécessaire. Vous pouvez également combiner plusieurs modèles de format. Par exemple, vous pouvez combiner les {month.integer} formats et {month.abbreviated} pour que le sélecteur de mois affiche le numéro et le nom du mois, comme ceci : 12 déc. Pour plus d’informations, consultez la section Exemples.

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, comme l’ajout de 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 forcée à être petite.

Voir aussi

• DayFormat
• YearFormat
• MonthVisible
• DateTimeFormatter
• Sélecteur de dates