語言

DatePicker.YearFormat 屬性

定義

命名空間:
Microsoft.UI.Xaml.Controls
編輯

取得或設定年份值的顯示格式。

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

屬性值

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

一個日期選擇器，欄位格式化。

備註

透過設定 YearFormat 屬性來更改年份選擇器的格式。

DatePicker 中每個 ComboBox 的字串內容由 DateTimeFormatter 建立。 你透過提供一個字串，該字串可以是格式範本或格式模式，來告知 DateTimeFormatter 如何格式化年份值。 常見的年度值範本與模式列於下表。

格式模式格式範本
'{year.full} |{年份.縮寫} |{年份。縮寫（n）}'『年份|year.full |年份。簡寫」
'{era.full} |{era.縮寫} |{era.縮寫（n）}'n/a

Note

「Era」僅在 CalendarIdentifier 設定為日本曆時適用。 日本曆法中，年份選擇器顯示年號。

如需完整的格式範本與格式模式清單，請參閱 DateTimeFormatter 類別文件中的備註區。

Note

如果日期選擇器可能只顯示在一個小區域，例如將整個字串值加進星期幾，某些日期格式應避免使用。 這些字串可能很長，如果 DatePicker 的寬度被限制得很小，可能會被剪斷。

適用於

另請參閱