Поділитися через

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

Застосовується до: Програми Canvas Copilot Studio Desktop flows Model-driven apps Power Platform CLI Dataverse functions Power Pages

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

Опис

  • DateValue функція перетворює рядок дати (наприклад, "01.01.2014") на значення дати й часу .

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

  • DateTimeValue функція перетворює рядок дати й часу (наприклад, "10 січня 2013 р.12:13") на значення дати й часу .

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

Нотатка

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

Дати мають використовувати один із таких форматів:

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

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

Щоб отримати додаткові відомості, див.

Синтаксис

DateValue( Рядок [, мова] )
DateTimeValue( Рядок [, мова ] )
TimeValue( Рядок [, мова ] )

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

DateValue( Динамічний )
DateTimeValue( Динамічний )
TimeValue( Динамічний )

  • Динамічний – обов'язковий аргумент. Динамічне значення , яке позначає дату або час. Прийнятні значення залежать від нетипізованого постачальника. Для 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, відобразиться підпис «Запізно!»
  • Last updated on