DatePicker.DayFormat 属性

定义

命名空间:

Microsoft.UI.Xaml.Controls

获取或设置日期值的显示格式。

public:
 property Platform::String ^ DayFormat { Platform::String ^ get(); void set(Platform::String ^ value); };

winrt::hstring DayFormat();

void DayFormat(winrt::hstring value);

public string DayFormat { get; set; }

var string = datePicker.dayFormat;
datePicker.dayFormat = string;

Public Property DayFormat As String

<DatePicker DayFormat="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}"/>

下面是一个 DatePicker ，它结合了 2 种格式模式，在日期选取器中显示数字日期和星期几。 此格式没有等效的格式模板。

<DatePicker DayFormat="{}{day.integer} {dayofweek.abbreviated}"/>

注解

通过设置 DayFormat 属性更改日期选取器的格式。

DatePicker 中每个 ComboBox 的字符串内容由 DateTimeFormatter 创建。 可以通过提供格式模板或格式模式的字符串来通知 DateTimeFormatter 如何设置日期值的格式。 下表列出了日值的常见模板和模式。

格式模式	格式模板
'{day.integer} |{day.integer (n) }'	“day”
'{dayofweek.full} |{dayofweek.abbreviated} |{dayofweek.abbreviated (n) }'	'dayofweek |dayofweek.full |dayofweek.abbreviated'

在某些情况下，使用格式模式可以更精确地控制格式设置。 例如，可以使用格式模式指定日期选取器始终显示 2 位数字，包括在需要时的前导 0。 还可以组合多种格式模式。 例如，可以组合 {day} 和 {dayofweek.abbreviated} 格式，使日期选取器同时显示数字日期和星期一，如下所示： 14 周四。 有关详细信息，请参阅示例部分。

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

注意

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

另请参阅

• MonthFormat
• YearFormat
• DayVisible
• DateTimeFormatter
• 日期选取器
• 使用模板和模式设置日期和时间格式