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 – 決定控制項的框線為實線、虛線、點線或無。

BorderThickness – 控制項框線的粗細。

Color – 控制項文字的色彩。

DateTimeZone – 是否要以 UTC 或使用者的 當地 時間顯示日期。

DisplayMode – 控制項是否允許使用者輸入 (編輯)、只顯示資料 (檢視) 或者已停用 (停用)。

DisabledBorderColor – 如果控制項的 DisplayMode 屬性設定為 Disabled，該控制項框線的色彩。

DisabledColor – 如果 DisplayMode 屬性設定為 Disabled，該控制項文字的色彩。

DisabledFill – 若其 DisplayMode 屬性設定為 Disabled，該控制項背景的色彩。

EndYear – 使用者可以設定 date-picker 控制項值的最終年份。

Fill – 控制項背景的色彩。

FocusedBorderColor – 當控制項為焦點時的控制項框線色彩。

FocusedBorderThickness – 當控制項為焦點時的控制項框線粗細。

Font – 文字可使用的字型家族名稱。

FontWeight – 控制項的文字字型粗細︰粗體、半粗體、正常，或較細。

Height – 控制項的頂端和底部邊緣之間的距離。

IconFill - 日期選擇器圖示的前景色彩。

IconBackground - 日期選擇器圖示的背景色彩。

InputTextPlaceholder – 在未輸入任何日期時顯示的說明性文字。

IsEditable – 是否可以編輯日期選擇器文字。 如果為 false，只能使用行事歷變更日期。

Italic – 控制項中的文字是否為斜體。

OnSelect – 在使用者點選或按一下控制項時，要執行的動作。

OnChange – 當使用者變更控制項的值時，要執行的動作。

OnChange 與 OnSelect之間的差異：如果使用者 點擊 造成變更時，OnSelect 和 OnChange 觸發相同的使用者動作 。在本案中，會在 OnChange 之前 觸發 OnSelect。

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不是使用者所預期的格式，請新增**標籤** 來說明接受的日期格式。

鍵盤支援

• TabIndex 必須是零或大於零，鍵盤使用者才能導覽到該處。
• 焦點指標必須清楚可見。 使用 FocusedBorderColor 和 FocusedBorderThickness 達成此目的。