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 )
範例
基本日期選擇器
新增日期選取器控制項,並將它命名為「Deadline」。
不知道如何新增、命名和設定控制項嗎?
新增**標籤** 控制項,並將其 Text 屬性設定為下列公式:
DateDiff(Today(), Deadline.SelectedDate) & " days to go!"
按下 F5 鍵,並在 Deadline 中選擇日期,然後按一下或點選確定。
標籤 控制項顯示今天與您所選日期之間的天數。
若要返回預設工作區,請按 Esc 鍵。
將日期選取器重設為預設日期
新增日期選取器控制項,並將它命名為「DateTimeReset」。
不知道如何新增、命名和設定控制項嗎?
新增**按鈕** 控制項,並將其 OnChange 屬性設定為下列公式:
Reset(DateTimeReset)
按下 F5 鍵,並在 DateTimeReset 中選擇新日期,然後按一下或點選確定。
請按此按鈕。 日期將重設回 DefaultDate (今天)。
若要返回預設工作區,請按 Esc 鍵。
協助工具指南
色彩對比
- 適用 標準色彩對比需求。
螢幕助讀程式支援
- AccessibleLabel 必須存在。
- 如果 IsEditable 為 True 且Format不是使用者所預期的格式,請新增**標籤** 來說明接受的日期格式。
鍵盤支援
- TabIndex 必須是零或大於零,鍵盤使用者才能導覽到該處。
- 焦點指標必須清楚可見。 使用 FocusedBorderColor 和 FocusedBorderThickness 達成此目的。
提示
當行事曆開啟時,按 Page up 和 Page down 瀏覽月份及按 Shift + Page up 和 Shift + Page down 瀏覽年份。