Power Apps 中的日期選擇器控制項

使用者可以選取以指定日期的控制項。

Description

如果您新增 日期選擇器 控制項，而不是 文字輸入 控制項，則有助於確保使用者以正確的格式指定日期。

索引鍵屬性

DefaultDate — 日期控制項的初始值，除非使用者變更它。

SelectedDate — 目前在日期控制項中選取的日期。 此日期以當地時間表示。

格式 – 控制項顯示日期且使用者指定日期的文字格式。 您可以將此屬性設定為 ShortDate （預設） 或 LongDate ，以根據此控制項的 Language 屬性來格式化日期。 您也可以將此屬性設定為運算式，例如 yyyy/mm/dd 如果您想要相同的格式，而不論語言為何。 例如：

• 如果使用者按一下或點選 2017 年的最後一天，則控制項會顯示 12/31/2017，Format 屬性會設定為 ShortDate，而 Language 屬性會設定為 en-us。
• 如果使用者按一下或點選 2017 年的最後一天，則控制項會顯示 2017 年 12 月 31 日 ， Format 屬性會設定為 LongDate，而 Language 屬性會設定為 fr-fr。

語言 — 決定用來格式化日期的語言，包括月份名稱。 如果未指定此屬性，使用者的裝置設定會決定語言。 支援的值包括 “EN-us” 和 “FR”。

其他屬性

AccessibleLabel — 螢幕助讀程式的標籤。

BorderColor – 控制項框線的色彩。

BorderStyle – 控制項的框線是 Solid、 Dashed、 Doted 還是 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 – 控制項頂部邊緣與其上層容器 (沒有上層容器時則為螢幕) 頂部邊緣之間的距離。

相關功能

年份 （ 日期時間值 ）

範例

基本日期選擇器

1. 新增 日期選擇器 控制項，並將其命名為 “Deadline”。

   不知道如何 新增、命名和設定控制項？

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 （今天）。

5. 若要返回預設工作區，請按 Esc 鍵。

協助工具指導方針

色彩對比

• 適用標準色彩對比度要求。

支援螢幕助讀程式

• AccessibleLabel 必須存在。
• 如果 IsEditable 為 true，且 Format 不是使用者預期的，請新增 Label 來說明接受的日期格式。

鍵盤支援

• TabIndex 必須為零或更大，鍵盤使用者才能流覽至它。
• 焦點指示器必須清晰可見。 使用 FocusedBorderColor 和 FocusedBorderThickness 來達成此目的。