Power Apps 中的 日期选取器 控件

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

描述

如果添加 日期选取器 控件而非 文本输入 控件,可帮助确保用户以正确的格式指定日期。

关键属性

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

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

Format – 控件显示日期和用户指定日期所使用的文本格式。 可以将此属性设置为 ShortDate(默认)或 LongDate,从而根据此控件的 Language 属性设置日期格式。 若要使用相同的格式,而不考虑语言,也可以将此属性设置为表达式(如 yyyy/mm/dd)。 例如:

  • 如果用户单击或点击 2017 年的最后一天,Format 属性设置为 ShortDate,且 Language 属性设置为 en-us,那么此控件显示 12/31/2017
  • 如果用户单击或点击 2017 年的最后一天,Format 属性设置为 LongDate,且 Language 属性设置为 fr-fr,那么此控件显示 dimanche 31 decembre 2017

Language – 确定设置日期格式所使用的语言,包括月份名称。 如果未指定此属性,语言将由用户设备设置决定。 支持的值包括“EN-US”和“FR”。

其他属性

AccessibleLabel – 屏幕阅读器标签。

BorderColor – 控件边框的颜色。

BorderStyle – 控件边框是 SolidDashedDotted 还是 None

BorderThickness – 控件边框的粗细。

Color – 控件中文本的颜色。

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

DisplayMode – 此控件是允许用户输入 (Edit)、仅显示数据 (View),还是已禁用 (Disabled)。

DisabledBorderColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件边框的颜色。

DisabledColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件中的文本颜色。

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

EndYear – 用户可将日期选取器控件的值设为的最后一个年份。

Fill – 控件的背景色。

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

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

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

FontWeight – 控件中文本的粗细:BoldSemiboldNormalLighter

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

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

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

InputTextPlaceholder – 未输入日期时显示的说明文本。

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

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

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

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

OnChangeOnSelect 之间的区别:如果用户的单击引起更改,将在同一个用户操作上触发 OnSelect 和 OnChange。在此情况下,OnSelect 在 OnChange 之前触发。

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

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

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

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

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

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

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

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

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

Visible – 控件显示还是隐藏。

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

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

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

Year( DateTimeValue )

示例

基本日期选取器

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

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

  2. 添加一个**标签** 控件,然后将 Text 属性设置为以下公式:

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

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

  3. F5,在 Deadline 中选择一个日期,然后选择确定

    此时,标签 控件显示今天距离所选日期还剩多少天。

  4. 要返回默认工作区,按 Esc。

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

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

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

  2. 添加一个**按钮** 控件,然后将 OnChange 属性设置为以下公式:

    Reset(DateTimeReset)
    
  3. F5,在 DateTimeReset 中选择一个新日期,然后选择确定

  4. 按此按钮。 日期将重置回 DefaultDate(今天)。

  5. 要返回默认工作区,按 Esc。

辅助功能准则

颜色对比度

屏幕阅读器支持

  • AccessibleLabel 必须存在。
  • 如果 IsEditable 为 true 并且Format不是用户预期的,请添加一个 标签 来说明可接受的日期格式。

键盘支持

提示

打开日历后,按上一页下一页在月份之间导航,按 Shift+上一页Shift+下一页在年份之间导航。

备注

您能告诉我们您的文档语言首选项吗? 进行简短调查。(请注意,此调查是英文版调查)

此调查大约需要七分钟。 不会收集个人数据(隐私声明)。