DatePicker.MonthFormat Свойство

Определение

Пространство имен:

Microsoft.UI.Xaml.Controls

Возвращает или задает формат отображения для значения месяца.

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"/>

Значение свойства

String

Platform::String

winrt::hstring

Формат отображения для значения месяца.

Примеры

Ниже приведен параметр DatePicker , отформатированный с помощью шаблонов форматирования, и DatePicker , отформатированный с помощью строк форматирования. Оба элемента управления DatePicker выглядят одинаково при запуске приложения, так как форматирование эквивалентно.

<!-- 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}"/>

Ниже приведен параметр DatePicker , объединяющий два шаблона формата для отображения номера и названия месяца в окне выбора месяца. К образцу формата можно добавлять строковые литералы, например круглые скобки вокруг сокращения месяца: ({month.abbreviated}). Для этого формата нет эквивалентного шаблона формата.

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

Комментарии

Измените формат средства выбора месяца, задав MonthFormat свойство .

Строковое содержимое каждого элемента ComboBox в DatePicker создается с помощью DateTimeFormatter. Вы указываете DateTimeFormatter , как отформатировать значение месяца, предоставив строку, которая является шаблоном формата или шаблоном формата. В следующей таблице перечислены распространенные шаблоны и шаблоны для значений месяцев.

шаблон формата	Шаблон форматирования
"{month.integer} | {month.integer(n)} '	'month.numeric'
"{month.full} | {month.abbreviated} | {month.abbreviated(n)}'	'month | month.full | month.abbreviated'

В некоторых случаях использование шаблона форматирования дает более точный контроль над форматированием. Например, можно использовать шаблон формата, чтобы указать, что средство выбора месяца всегда отображает 2 цифры, включая 0 в начале при необходимости. Вы также можете сочетать несколько шаблонов форматирования. Например, можно объединить {month.integer} форматы и {month.abbreviated} , чтобы средство выбора месяца отображало номер и название месяца, как показано ниже: 12 декабря. Дополнительные сведения см. в разделе Примеры.

Полный список шаблонов форматирования и шаблонов форматирования см. в разделе Примечания документации по классу DateTimeFormatter .

Примечание

Некоторые форматы даты следует избегать, если средство выбора даты может отображаться в небольшой области, например при добавлении полного строкового значения дня недели. Эти строки могут быть длинными и обрезанными, если ширина DatePicker вынуждена быть небольшой.

См. также раздел

• DayFormat
• YearFormat
• MonthVisible
• DateTimeFormatter
• Выбор даты