Power Apps 中的日期选取器控件

用户可选择以指定日期的控件。

Description

如果添加 日期选取器 控件而不是 文本输入 控件，则有助于确保用户以正确的格式指定日期。

键属性

DefaultDate – 日期控件的初始值，除非用户更改它。

SelectedDate – 当前在日期控件中选择的日期。 此日期以本地时间表示。

格式 – 控件显示日期和用户指定日期的文本格式。 可以将此属性设置为 ShortDate （默认值）或 LongDate ，以基于此控件 的语言 属性设置日期的格式。 如果需要相同的格式而不考虑语言，还可以将此属性设置为表达式，例如 yyyy/mm/dd 。 例如：

• 如果用户单击或点击 2017 年的最后一天，则控件显示 12/31/2017 ，则 Format 属性设置为 ShortDate， 语言 属性设置为 en-us。
• 如果用户单击或点击 2017 年最后一天，则控件显示 dimanche 31 decembre 2017 ，则 Format 属性设置为 LongDate， 并且 Language 属性设置为 fr-fr。

语言 - 确定用于设置日期格式的语言，包括月份的名称。 如果未指定此属性，则用户的设备设置将确定语言。 支持的值包括“EN-us”和“FR”。

其他属性

AccessibleLabel – 屏幕阅读器标签。

BorderColor – 控件边框的颜色。

BorderStyle – 控件的边框是 Solid、 Dashed、 Dotted 还是 None。

BorderThickness – 控件边框的粗细。

颜色 – 控件中的文本颜色。

DateTimeZone – 是使用 UTC 还是用户的 本地 时间显示日期。

DisplayMode – 控件是否允许用户输入（编辑）、仅显示数据（视图）或已禁用（已禁用）。

DisabledBorderColor – 如果控件的 DisplayMode 属性设置为 Disabled，则控件边框的颜色。

DisabledColor – 控件中的文本颜色（如果控件的 DisplayMode 属性设置为 Disabled）。

DisabledFill – 控件的 DisplayMode 属性设置为 Disabled 时的背景色。

EndYear – 用户可以设置日期选取器控件值的最新年份。

填充 – 控件的背景色。

FocusedBorderColor – 当控件聚焦时控件边框的颜色。

FocusedBorderThickness – 当控件聚焦时控件边框的粗细。

字体 – 显示文本的字体系列的名称。

FontWeight – 控件中文本的粗细： 粗体、 半曲、 普通或 较轻。

高度 – 控件的上边缘和下边缘之间的距离。

IconFill – 日期选取器图标的前景色。

IconBackground – 日期选取器图标的背景色。

InputTextPlaceholder – 如果未输入日期，则显示的说明文本。

IsEditable – 是否可以编辑日期选取器文本。 如果为 false，则只能使用日历更改日期。

斜体 – 控件中的文本是否为斜体。

OnSelect – 当用户点击或单击控件时要执行的作。

OnChange – 当用户更改控件值时要执行的作。

OnChange 和 OnSelect 之间的差异：如果用户单击会导致更改，则在同一用户作上的 OnSelect 和 OnChange 触发器。 在这种情况下，OnSelect 在 OnChange 之前 触发。

PaddingBottom – 控件中的文本与该控件的下边缘之间的距离。

PaddingLeft – 控件中的文本与该控件的左边缘之间的距离。

PaddingRight – 控件中的文本与该控件右边缘之间的距离。

PaddingTop – 控件中的文本与该控件的上边缘之间的距离。

重置 - 是否应将日期选取器控件重置为 DefaultDate 值。

大小 – 控件上显示的文本的字号。

StartOfWeek – 日期选取器控件的第一天列中要显示的星期几。

StartYear – 用户可以设置日期选取器控件的值的最早年份。

TabIndex – 相对于其他控件的键盘导航顺序。

可见 – 控件是显示还是隐藏。

宽度 – 控件的左边缘和右边缘之间的距离。

X – 控件左边缘与其父容器（如果没有父容器，则为屏幕）左边缘之间的距离。

Y – 控件上边缘与其父容器（如果没有父容器，则为屏幕）上边缘之间的距离。

相关函数

Year（ DateTimeValue ）

例子

基本日期选取器

1. 添加 日期选取器 控件，并将其命名为“截止时间”。

   不知道如何 添加、命名和配置控件？

2. 添加 Label 控件，并将其 Text 属性设置为以下公式：

    DateDiff(Today(), Deadline.SelectedDate) & " days to go!"
   

   想要了解有关 DateDiff 函数 或其他函数的详细信息？

3. 按 F5，在 截止时间中选择日期，然后选择“ 确定”。

   “标签”控件显示今天与所选日期之间的天数。

4. 若要返回到默认工作区，请按 Esc。

将日期选取器重置为默认日期

1. 添加 日期选取器 控件，并将其命名为“DateTimeReset”。

   不知道如何 添加、命名和配置控件？

2. 添加 Button 控件，并将其 OnChange 属性设置为以下公式：

   Reset(DateTimeReset)
   

3. 按 F5，在 DateTimeReset 中选择新日期，然后选择“ 确定”。

4. 按此按钮。 日期将重置回 DefaultDate （Today）。

5. 若要返回到默认工作区，请按 Esc。

辅助功能指南

颜色对比度

• 标准颜色对比度要求适用。

屏幕阅读器支持

• AccessibleLabel 必须存在。
• 如果 IsEditable 为 true 且 Format 不是用户期望的，请添加 一个标签 来解释接受的日期格式。

键盘支持

• TabIndex 必须为零或更大，以便键盘用户可以导航到它。
• 焦点指示器必须清晰可见。 使用 FocusedBorderColor 和 FocusedBorderThickness 来实现此目的。