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

以下是結合 2 種格式模式的 DatePicker ，以在月份選擇器中顯示月份號碼和名稱。 您可以將常值字串新增至格式模式，例如月份縮寫前後的括號： ({month.abbreviated})。 此格式沒有對等的格式範本。

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

備註

藉由設定 MonthFormat 屬性來變更月份選擇器的格式。

DatePicker 中每個 ComboBox 的字串內容是由 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 Dec。如需詳細資訊，請參閱一節。

如需格式範本和格式模式的完整清單，請參閱 DateTimeFormatter 類別檔的一節。

注意

如果日期選擇器可能顯示在小型區域中，例如新增星期幾的完整字串值，則應該避免某些日期格式。 如果 DatePicker 的寬度強制很小，這些字串可能很長，而且可能會裁剪。

另請參閱

• DayFormat
• YearFormat
• MonthVisible
• DateTimeFormatter
• 日期選擇器