Функции DateValue, TimeValue и DateTimeValue

  • Статия

Отнася се за: Canvas apps Desktop flows Model-driven apps Power Platform CLI

Преобразува дата, час или и двете в низ за стойност на дата/час.

Описание

  • DateValue функция преобразува низ за дата (например „10/01/2014“) в стойност дата/час.

  • TimeValue функция преобразува низ за час (например "12:15 PM") в стойност дата/час.

  • DateTimeValue функция преобразува низ за дата и час (например „10 януари, 2013 12:13 AM“) в стойност дата/час.

DateValue функция игнорира всяка информация за времето в низ за дата и TimeValue функция игнорира всяка информация за дата във времевия низ.

Бележка

Функциите DateValue, TimeValue и DateTimeValue по подразбиране използват езика от настройките на текущия потребител. Можете да го отмените, за да гарантирате, че струните са интерпретирани правилно. Например „10/1/1920“ се тълкува като October 1st на "en"и January 10th на "fr".

Датите трябва да бъдат в един от следните формати:

  • MM/DD/YYYY или MM-DD-YYYY
  • DD/MM/YYYY или DD-MM-YYYY
  • YYYY/MM/DD или YYYY-MM-DD
  • MM/DD/YY или MM-DD-YY
  • DD/MM/YY или DD-MM-YY
  • 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( DateValue( Startdate.Text ), DateTimeFormat.LongDate )

    Устройството е настроено на en локал показва етикета като Saturday, October 11, 2014.

    Бележка

    Можете да използвате няколко опции с номериране DateTimeFormat. За да се покаже списък с опции, въведете параметъра, последван от точка или период (.) в лентата с формули или проверете справката за функцията Text.

  • Конвертирайте дата от низ на френски език и показвайте резултата като дълга дата. В този пример месеците и денят от месеца се тълкуват различно от английския.

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

    Устройството е настроено на en локал показва етикета като Monday, November 10, 2014.

Ако сте въвели October 20, 2014 вместо това:

  • Преобразувайте дата от низ в езика на потребителя и изчислете разликата между два дни, в дни

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

    Устройството е настроено на en локал показва етикета като 9, указващ броя дни между 11 и 20 октомври. Функцията DateDiff също може да покаже разликата в месеци, тримесечия или години.

DateTimeValue

Ако сте въвели 10/11/2014 1:50:24.765 PM в име за въвеждане на текст с име Start и след това задайте Текст свойството на етикет към следната формула:

  • Конвертирайте както низ за дата, така и време в текущия локал.

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

    Устройството е настроено на en локал показва етикета като Saturday, October 11, 2014 1:50:24 PM.

    Бележка

    Можете да използвате няколко опции с номериране DateTimeFormat. За да се покаже списък с опции, въведете параметъра, последван от точка или период (.) в лентата с формули или проверете справката за функцията Text.

  • Конвертирайте както низ за дата, така и време на френския локал. Месецът и денят от месеца се тълкуват различно.

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

    Устройството е настроено на en локал показва етикета като Monday, November 10, 2014 1:50:24 PM.

  • Преобразувайте както низ за дата, така и време в езика на потребителя и показвайте резултата с дробна секунда.

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

    Устройството е настроено на en локал показва етикета като Saturday, October 11, 2014 01:50:24.765 PM.

    Като алтернатива можете да укажете hh:mm:ss.f или hh:mm:ss.ff, за да закръгляте времето до най-близката 10та или 100на от секундата,

TimeValue

Назовете контрола за въвеждане на текст FinishedAt и задайте Текст свойство на етикет към тази формула:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Ако въведете 4:59:59.999 PM в FinishedAt контрол, етикетът показва "You made it!"
  • Ако въведете 5:00:00.000 PM в FinishedAt контрол, етикетът показва "Too late!"