DatePicker.MonthFormat 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定月份值的顯示格式。
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"/>
屬性值
月份值的顯示格式。
範例
這裡有一個用格式範本格式化的 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 屬性來更改月份選擇器的格式。
DatePicker 中每個 ComboBox 的字串內容由 DateTimeFormatter 建立。 你透過提供一個字串,該字串可以是格式範本或格式模式,指示 DateTimeFormatter 如何格式化月份值。 常見的月份值範本與模式列於下表。
| 格式模式 | 格式範本 |
|---|---|
| '{month.integer} |{month.integer(n)} ' | 「月份。數字」 |
| '{month.full} |{月份.縮寫} |{month.abbreviated(n)}' | 『月份|||』月滿 |月份。縮寫」 |
在某些情況下,使用格式模式能讓你更精確地控制格式。 例如,你可以使用格式模式來指定月份選擇器總是顯示兩位數字,必要時會加上前方的 0。 你也可以結合多種格式的圖樣。 例如,你可以結合 {month.integer} 和 {month.abbreviated} 格式,讓月份選擇器顯示月份號碼和名稱,像這樣: 12 Dec。更多資訊請參閱範例章節。
如需完整的格式範本與格式模式清單,請參閱 DateTimeFormatter 類別文件中的備註區。
Note
如果日期選擇器可能只顯示在一個小區域,例如將整個字串值加進星期幾,某些日期格式應避免使用。 這些字串可能很長,如果 DatePicker 的寬度被限制得很小,可能會被剪斷。