Share via

Функції DateValue, TimeValue і DateTimeValue

  • Стаття

Застосовується до: програм Canvas Потоків робочого столу Програм, Power Platform керованих моделлю, CLI

Перетворення дати, часу або і того й іншого в рядку на значення дати й часу.

Опис

  • Функція DateValue перетворює рядок дати (як-от «10/01/2014») на значення дати й часу.

  • Функція TimeValue перетворює рядок часу (наприклад, «12:15 PM» або «12:15») на значення дати й часу.

  • Функція DateTimeValue перетворює рядок дати та часу (як-от «10 січня 2013 р. 00:13») на значення дати й часу.

Функція DateValue ігнорує відомості про час у рядку дати, а функція TimeValue ігнорує відомості про дату в рядку часу.

Нотатка

За замовчуванням функції «DateValue», «TimeValue» та «DateTimeValue» використовують мову з настройок поточного користувача. Це можна змінити для забезпечення належної інтерпретації рядків. Наприклад, «10/1/1920» інтерпретується як 1 жовтня в разі англійської мови («en») та як 10 січня в разі французької мови («fr»).

Дати мають бути в одному із зазначених нижче форматів.

  • ММ/ДД/РРРР або ММ-ДД-РРРР
  • ДД/ММ/РРРР або ДД-ММ-РРРР
  • РРРР/ММ/ДД або РРРР-ММ-ДД
  • ММ/ДД/РР або ММ-ДД-РР
  • ДД/ММ/РР або ДД-ММ-РР
  • DD Mon YYYY
  • Month DD, YYYY

Відомості про перетворення числових компонентів дати, місяця та року див. в розділі Date.
Відомості про перетворення числових компонентів години, хвилини та секунди див. в розділі Time.

Додаткові відомості див. в розділах про:

Синтаксис

DateValue( String [, Language ])
DateTimeValue( String [, Language ])
TimeValue( String [, Language ])

  • String — обов'язковий аргумент. Текстовий рядок, що містить дату, час або об’єднане значення дати й часу.
  • Language – необов’язковий аргумент. Рядок мови, як той, що повертається першими двома символами від функції Language. Якщо не визначено, використовується мова настройок поточного користувача.

DateValue( Untyped )
DateTimeValue( Untyped )
TimeValue( Untyped )

  • Untyped – обов’язковий аргумент. Нетипізований об’єкт, який відображає дату або час. Прийнятні значення залежать від нетипізованого постачальника. Для JSON нетипізований об’єкт може бути рядком JSON, який містить дату й час у форматі ISO 8601. Дати та час в інших форматах призведуть до помилки. Рекомендовано спочатку перетворити такі значення на Текст, а потім на дату або час. Пам’ятайте, що для спілкування із зовнішніми системами важливо коректно використовувати часові пояси й формати відповідно до регіональних стандартів.

Приклади

DateValue

Якщо ввести 10/11/2014 в елемент керування «Ввід тексту» з ім’ям Startdate (Дата початку), а потім настроїти властивість Text елемента керування «Підпис» відповідно до вказаних нижче формул:

  • Дату буде перетворено з рядка мовою користувача, а результат відображено як повну дату.

    Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )

    Пристрій, на якому настроєно англійську мову (en), відображатиме такий підпис: субота, 11 жовтня 2014 р.

    Нотатка

    Можна скористатися кількома параметрами за допомогою перелічення DateTimeFormat. Щоб відобразити список параметрів, уведіть параметр, після якого стоїть крапка (.), у рядку формули або перевірте посилання на функцію Text.

  • Дату буде перетворено з рядка французькою мовою, а результат відображено як повну дату. У цьому прикладі місяць і день місяця інтерпретуються інакше в порівнянні з англійською мовою.

    Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )

    Пристрій, на якому настроєно англійську мову (en), відображатиме такий підпис: понеділок, 10 листопада 2014 р.

Якщо замість цього ввести 20 жовтня 2014 р.:

  • Дату буде перетворено з рядка мовою користувача та буде обчислено різницю між двома днями (у днях).

    DateDiff( DateValue( Startdate.Text ), Today() )

    Пристрій, на якому настроєно англійську мову (en), відображатиме підпис «9», що вказуватиме на кількість днів між 11 жовтня та 20 жовтня. Функція DateDiff також може відображати різницю в місяцях, кварталах або роках.

DateTimeValue

Якщо ввести 10/11/2014 1:50:24.765 PM в елемент керування «Ввід тексту» з ім’ям Start (Початок), а потім настроїти властивість Text елемента керування «Підпис» відповідно до вказаних нижче формул:

  • Буде перетворено рядок дати й часу поточною мовою.

    Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )

    Пристрій, на якому настроєно англійську мову (en), відображатиме такий підпис: субота, 11 жовтня 2014 р. 1:50:24 PM.

    Нотатка

    Можна скористатися кількома параметрами за допомогою перелічення DateTimeFormat. Щоб відобразити список параметрів, уведіть параметр, після якого стоїть крапка (.), у рядку формули або перевірте посилання на функцію Text.

  • Буде перетворено рядок дати й часу французькою мовою. Місяць і день місяця інтерпретуються по-різному.

    Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )

    Пристрій, на якому настроєно англійську мову (en), відображатиме такий підпис: понеділок, 10 листопада 2014 р. 1:50:24 PM.

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

    Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )

    Пристрій, на якому настроєно англійську мову (en), відображатиме такий підпис: субота, 11 жовтня 2014 р. 01:50:24.765 PM.

    Також можна указати hh:mm:ss.f (гг:хх:сс.д) або hh:mm:ss.ff (гг:хх:сс.дд), щоб округлити час до найближчої 10-ї або 100-ї частини секунди.

TimeValue

Дайте елементу керування «Ввід тексту» ім’я FinishedAt (Час закінчення) та настройте властивість Text елемента керування «Підпис» відповідно до нижченаведеної формули.

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Якщо ввести 4:59:59.999 PM в елементі керування з іменем FinishedAt, відобразиться підпис «У тебе вийшло!»
  • Якщо ввести 5:00:00.000 PM в елементі керування з іменем FinishedAt, відобразиться підпис «Запізно!»