DatePicker.YearFormat 屬性

定義

命名空間:

Windows.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} |{year.abbreviated} |{year.abbreviated (n) }'	'year |year.full |year.abbreviated'
'{era.full} |{era.abbreviated} |{era.abbreviated (n) }'	n/a

注意

只有在 CalendarIdentifier 設定為日曆時，才會套用 「Era」。 針對日曆，紀元會顯示在年份選擇器中。

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

注意

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

另請參閱

• DateTimeFormatter
• DayFormat
• MonthFormat
• YearVisible
• 日期選擇器