日期和时间控件向你提供了标准的本地化方法，可供用户在你的应用中查看并设置日期和时间值。 本文提供设计指南，并帮助你选取正确的控件。

打开 WinUI 3 库应用，并查看 DateAndTime 在操作中。

WinUI 3 库应用包括大多数 WinUI 3 控件、特性和功能的交互式示例。 通过 Microsoft Store 获取应用，或在 GitHub 上获取源代码

有四个日期和时间控件可供选择；要使用的控件取决于你的方案。 使用此信息来选取要在你的应用中使用的正确控件。

CalendarView 让用户查看可按月份、年份或十年期浏览的日历，并与之交互。 用户可选择单个日期或一组日期。 它没有选取器图面，并且日历始终可见。

日历视图由 3 种单独视图构成：月份视图、年份视图和十年期视图。 默认情况下，它通过打开月视图启动，但你可以将其他视图指定为启动视图。

CalendarDatePicker 是一个下拉式控件，该控件已针对从日历视图中选取某个日期进行了优化，尤其是能够显示诸如星期几或丰富的日历信息等上下文信息。 你可以修改日历以提供其他上下文或限制可用日期。

如果尚未设置日期，入口点将显示占位符文本；否则，它将显示选择的日期。 当用户选择该入口点时，日历视图将进行扩展以供用户选择日期。 日历视图将会覆盖其他 UI；它不会将其他 UI 推开。

DatePicker 控件提供了一种用于选择特定日期的标准化方法。

入口点显示选定的日期，当用户选择该入口点时，会从中间垂直展开一个选取器图面以供用户进行选择。 日期选取器会覆盖其他 UI；它不会将其他 UI 推开。

TimePicker 用于为约会或出发时间等事项选择一个时间值。 它是由用户或使用代码设置的静态显示方式，但不会更新以显示当前时间。

入口点显示选定的时间，当用户选择该入口点时，会从中间垂直展开一个选取器图面以供用户进行选择。 时间选取器会覆盖其他 UI；它不会将其他 UI 推开。

有关特定于每个日期和时间控件的信息和示例，请参阅以下这些文章。

此示例演示如何结合使用 DatePicker 和 TimePicker，使用户能够选择其到达日期和时间。 可以处理 SelectedDateChanged 和 SelectedTimeChanged 事件以更新名为 arrivalDateTime 的单个 DateTime 实例。 用户还可以在设置日期和时间选取器后将其清除。

XAML 日期控件支持 Windows 支持的各种日历系统。 这些日历均在 Windows.Globalization.CalendarIdentifiers 类中指定。 每个控件均使用与应用的默认语言对应的正确日历，还可以设置 CalendarIdentifier 属性以使用特定的日历系统。

时间选取器控件支持在 Windows.Globalization.ClockIdentifiers 类中指定的每个时钟系统。 若要使用 12 小时制时钟或 24 小时制时钟，可以设置 ClockIdentifier 属性。 该属性的类型是字符串，但必须使用对应于 ClockIdentifiers 类的静态字符串属性的值。 如下所示：TwelveHour（字符串“12HourClock”）和TwentyFourHour（字符串“24HourClock”）。 “12HourClock”是默认值。

XAML 日期和时间控件中所使用的日期对象具有不同的表示形式，具体取决于你的编程语言。

相关概念是 Calendar 类，它对在上下文中解释日期的方式产生影响。 所有 Windows 运行时应用都可以使用 Windows.Globalization.Calendar 类。 C# 和 Visual Basic 应用还可以使用 System.Globalization.Calendar 类，该类具有非常类似的功能。 （Windows 运行时应用可使用 .NET 日历基类而非诸如 GregorianCalendar 的特定实现。）

.NET 还支持名为 DateTime 的类型，该类型可隐式转换为 DateTimeOffset。 因此，可能会看到要在 .NET 代码中用于设置实际上是 DateTimeOffset 的值的“DateTime”类型。 有关 DateTime 和 DateTimeOffset 之间的区别的详细信息，请参阅 DateTimeOffset 类中的“备注”。

注意

获取日期对象的属性不可以设置为 XAML 属性字符串，因为 Windows 运行时 XAML 解析器不具有用于将字符串转换为日期（作为 DateTime/DateTimeOffset 对象）的转换逻辑。 通常使用代码设置这些值。 另一个可行的方法是定义可用作数据对象或在数据上下文中可用的日期，然后将该属性设置为引用 {Binding} 标记扩展表达式的 XAML 属性，以便可以作为数据访问该日期。