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) }'	不适用

注意

仅当 CalendarIdentifier 设置为日本日历时，“Era”才适用。 对于日本历，纪元显示在年份选取器中。

有关格式模板和格式模式的完整列表，请参阅 DateTimeFormatter 类文档的“备注”部分。

注意

如果日期选取器可能显示在较小的区域中，例如添加星期几的完整字符串值，则应避免某些日期格式。 这些字符串可以很长，如果强制 DatePicker 的宽度较小，则可能会剪裁这些字符串。

另请参阅

• DateTimeFormatter
• DayFormat
• MonthFormat
• YearVisible
• 日期选取器