Елемент керування "Вибір дати" в Power Apps

Елемент керування, який може вибрати користувач, щоб указати дату.

Опис

Щоб бути певним, що користувач укаже дату в правильному форматі, слід додати елемент керування Вибір дати замість елемента керування Text input.

Ключові властивості

DefaultDate – початкове значення елемента керування датою, доки користувач не змінить його.

SelectedDate – дата, вибрана в елементі керування датою. Ця дата вказана за місцевим часовим поясом.

Формат – формат тексту, в якому елемент керування відображає дату, а користувач указує дату. Для цієї властивості можна вказати ShortDate (за замовчуванням) або LongDate, щоб форматувати дати відповідно до властивості Мова цього елемента керування. Цю властивість також можна встановити як вираз, наприклад рррр/мм/дд, якщо потрібно використовувати однаковий формат незалежно від мови. Наприклад:

• Елемент керування відобразить 12/31/2017, якщо користувач вибере останній день 2017 року, при цьому для властивості Формат встановлено значення ShortDate, а для властивості Мова – значення en-us.
• Елемент керування відобразить dimanche 31 decembre 2017, якщо користувач вибере останній день 2017 року, при цьому для властивості Формат встановлено значення LongDate, а для властивості Мова – значення fr-fr.

Мова – визначає мову, яка використовується для форматування дат, включно з назвами місяців. Якщо ця властивість не вказана, параметр пристрою користувача визначає мову. Підтримувані значення: "EN-us" та "FR".

Додаткові властивості

AccessibleLabel  – підпис для невізуальних екранів.

BorderColor  – колір межі елемента керування.

BorderStyle  – визначає стиль межі елемента керування: Суцільна, Штрихова, Пунктирна або Немає.

BorderThickness  – товщина межі елемента керування.

Color  – колір тексту в елементі керування.

DateTimeZone – визначає, чи слід відображати дату у форматі UTC або за місцевим часом користувача.

DisplayMode – визначає, чи елемент керування дозволяє користувачу вводити дані ("Редагувати"), лише відображає дані ("Подання") або є вимкнутим ("Вимкнуто").

DisabledBorderColor  – колір межі елемента керування, якщо для властивості DisplayMode елемента керування встановлено значення Disabled (Вимкнуто).

DisabledColor  – колір тексту в елементі керування, якщо для властивості DisplayMode елемента керування встановлено значення Disabled.

DisabledFill  – колір фону елемента керування, якщо для властивості DisplayMode елемента керування встановлено значення Disabled.

EndYear – останній рік, для якого користувач може встановити значення в елементі керування "Вибір дати".

Fill  – колір фону елемента керування.

FocusedBorderColor  – колір межі елемента керування, коли він перебуває у фокусі.

FocusedBorderThickness  – товщина межі елемента керування, коли він перебуває у фокусі.

Font  – ім’я сімейства шрифтів, що використовується для відображення тексту.

FontWeight  – стиль шрифту в елементі керування: Жирний, Напівжирний, Звичайний або Ненасичений.

Height  – відстань між верхнім і нижнім краями елемента керування.

IconFill – колір переднього плану піктограми вибору дати.

IconBackground – колір фону піктограми вибору дати.

InputTextPlaceholder – пояснювальний текст, який відображається, коли не введено жодної дати.

IsEditable – чи можна редагувати текст вибору дати. Якщо встановлено значення "False", то дату можна змінити лише за допомогою календаря.

Italic  – виділення тексту в елементі керування курсивом.

OnSelect – дії, які виконуються, коли користувач натискає елемент керування.

OnChange – дії, які виконуються, коли користувач змінює значення елемента керування.

Різниця між OnChange та OnSelect: OnSelect та OnChange реагують на однакові дії користувача, якщо в результаті клацання виникає зміна.У такому випадку OnSelect реагує раніше від OnChange.

PaddingBottom  – відстань між текстом в елементі керування та нижнім краєм цього елемента керування.

PaddingLeft  – відстань між текстом в елементі керування та лівим краєм цього елемента керування.

PaddingRight  – відстань між текстом в елементі керування та правим краєм цього елемента керування.

PaddingTop  – відстань між текстом в елементі керування та верхнім краєм цього елемента керування.

Reset – чи слід скинути елемент керування вибору дати до значення DefaultDate.

Size  – розмір шрифту тексту, що відображається на елементі керування.

StartOfWeek – день тижня, який відображається в стовпці першого дня елемента керування "Вибір дати".

StartYear – перший рік, для якого користувач може встановити значення в елементі керування "Вибір дати".

TabIndex  – порядок переходів за допомогою клавіатури відносно інших елементів керування.

Visible  – відображення або приховання елемента керування.

Width  – відстань між лівим і правим краями елемента керування.

X  – відстань між лівим краєм елемента керування та лівим краєм його батьківського контейнера (екрана, якщо батьківський контейнер відсутній).

Y  – відстань між верхнім краєм елемента керування та верхнім краєм батьківського контейнера (екрана, якщо батьківський контейнер відсутній).

Пов’язані функції

Рік( DateTimeValue )

Приклади

Основний засіб вибору дати

1. Додайте елемент керування Вибір дати й назвіть його «Кінцевий термін».

   Не знаєте, як додати, іменувати та настроїти елемент керування?

2. Додайте елемент Підпис і задайте для його властивості Text таку формулу:

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

   Потрібні додаткові відомості про функцію DateDiff або інші функції?

3. Натисніть клавішу F5, виберіть дату Кінцевий термін і натисніть кнопку OK.

   В елементі керування Label відображається кількість днів від сьогодні й до вибраної дати.

4. Щоб повернутися до робочої області за замовчуванням, натисніть клавішу Esc.

Скинути вибір дати до дати за замовчуванням

1. Додайте елемент керування Вибір дати й назвіть його «DateTimeReset».

   Не знаєте, як додати, іменувати та настроїти елемент керування?

2. Додайте елемент Кнопка і задайте для його властивості OnChange таку формулу:

   Reset(DateTimeReset)
   

3. Натисніть клавішу F5, виберіть нову дату DateTimeReset і натисніть кнопку OK.

4. Натисніть цю кнопку. Дату буде скинуто до значення DefaultDate (сьогодні).

5. Щоб повернутися до робочої області за замовчуванням, натисніть клавішу Esc.

Рекомендації щодо спеціальних можливостей

Контрастність кольору

• Застосовуються стандартні вимоги до контрастності кольору.

Підтримка зчитування екрана

• Має бути присутня властивість AccessibleLabel.
• Якщо значення IsEditable істинне, а Форат неочікуваний користувачем, додайте Label для пояснення прийнятих форматів дат.

Підтримка клавіатури

• Для властивості TabIndex має бути встановлено значення "нуль" або більше, щоб користувачі клавіатури могли перейти до неї.
• Індикатори фокусу мають бути чітко видимі. Для цього використовуйте FocusedBorderColor і FocusedBorderThickness.