Функции DateValue, TimeValue и DateTimeValue в PowerAppsDateValue, TimeValue, and DateTimeValue functions in PowerApps

Преобразует дату, время или оба этих параметра в строке в значение даты и времени.Converts a date, a time, or both in a string to a date/time value.

ОписаниеDescription

Функция DateValue преобразует строку даты (например "10/01/2014") в значение даты и времени.The DateValue function converts a date string (for example, "10/01/2014") to a date/time value.

Функция TimeValue преобразует строку времени (например "12:15 PM") в значение даты и времени.The TimeValue function converts a time string (for example, "12:15 PM") to a date/time value.

Функция DateTimeValue преобразует строку даты и времени (например "January 10, 2013 12:13 AM") в значение даты и времени.The DateTimeValue functions converts a date and time string (for example, "January 10, 2013 12:13 AM") to a date/time value.

Функция DateValue игнорирует любые сведения о времени в строке даты, а функция TimeValue игнорирует любые сведения о дате в строке времени.The DateValue function ignores any time information in the date string, and the TimeValue function ignores any date information in the time string.

По умолчанию используется язык текущего пользователя, но это значение можно переопределить, чтобы строки интерпретировались правильно.By default, the language used is that of the current user, but you can override this to ensure that strings are interpreted properly. Например, для "en" строка "10/1/1920" интерпретируется как 1ое октября, а для "fr" — как 10ое января.For example, "10/1/1920" is interpreted as October 1st in "en" and as January 10th in "fr".

Даты должны быть указаны в одном из следующих форматов:Dates must be in one of these formats:

  • ММ/ДД/ГГГГMM/DD/YYYY
  • ДД/ММ/ГГГГDD/MM/YYYY
  • ДД Мес ГГГГDD Mon YYYY
  • Месяц ДД, ГГГГMonth DD, YYYY

Ознакомьтесь с функциями Date и Time, чтобы преобразовать числовые компоненты (дата, месяц, год, час, минута и секунда).See the Date and Time functions to convert from numeric components date, month, and year, and hour, minute, and second.

Ознакомьтесь также с дополнительными сведениями в статье о работе с датами и временем.Also see working with dates and times for more information.

Чтобы преобразовать числа, см. статью о функции Value.To convert numbers, see the Value function.

СинтаксисSyntax

DateValue( Строка [, Язык ])DateValue( String [, Language ])
DateTimeValue( Строка [, Язык ])DateTimeValue( String [, Language ])
TimeValue( Строка [, Язык ])TimeValue( String [, Language ])

  • строка — обязательный аргумент.String - Required. Текстовая строка, которая содержит дату, время или комбинированное значение даты и времени.A text string that contains a date, time, or combination date and time value.
  • Язык — необязательный аргумент.Language - Optional. Строка языка, такая как возвращается первыми двумя знаками из функции Language.A language string, such as would be returned by the first two characters from the Language function. Если этот аргумент не указан, то используется язык клиента текущего пользователя.If not provided, the language of the current user's client is used.

ПримерыExamples

DateValueDateValue

Если вы ввели 10/11/2014 в элемент управления для ввода текста с именем Startdate, а затем задали свойству Text метки такое значение функции:If you typed 10/11/2014 into a text-input control named Startdate and then set the Text property of a label to this function:

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

    Метка отобразит Saturday, October 11, 2014, если на компьютере выбран языковой стандарт en.The label would show Saturday, October 11, 2014, if your computer were set to the en locale.

    Примечание

    С параметром DateTimeFormat можно использовать несколько вариантов, отличных от LongDateTime.You can use several options, other than LongDateTime, with the DateTimeFormat parameter. Чтобы отобразить список этих вариантов, в поле функции введите параметр, а сразу за ним поставьте восклицательный знак.To display a list of those options, type the parameter, followed immediately by an exclamation point, in the function box.

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

    Метка отобразит Monday, November 10, 2014.The label would show Monday, November 10, 2014.

Если вы сделали то же самое для даты October 20, 2014:If you did the same thing on October 20, 2014:

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

    Если на компьютере выбран языковой стандарт en, то метка отобразит 9, что означает количество дней между 11 октября и 20 октября.If your computer were set to the en language, the label would show 9, indicating the number of days between October 11 and October 20. Функция DateDiff также может показывать разницу в месяцах, кварталах или годах.The DateDiff function can also show the difference in months, quarters, or years.

DateTimeValueDateTimeValue

Если вы ввели 10/11/2014 1:50:24.765 PM в элемент управления для ввода текста с именем Start, а затем задали свойству Text метки такое значение функции:If you typed 10/11/2014 1:50:24.765 PM into a text-input control named Start and then set the Text property of a label to this function:

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

    Метка отобразит Saturday, October 11, 2014 1:50:24 PM, если на компьютере выбран языковой стандарт "en".The label would show Saturday, October 11, 2014 1:50:24 PM if your computer were set to the "en" locale.

    Примечание

    С параметром DateTimeFormat можно использовать несколько вариантов, отличных от LongDateTime.You can use several options, other than LongDateTime, with the DateTimeFormat parameter. Чтобы отобразить список этих вариантов, в поле функции введите параметр, а сразу за ним поставьте восклицательный знак.To display a list of those options, type the parameter, followed immediately by an exclamation point, in the function box.

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

    Метка отобразит Monday, November 10, 2014 1:50:24 PM.The label would show Monday, November 10, 2014 1:50:24 PM.

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

    Метка отобразит Saturday, October 11, 2014 01:50:24:765 PM, если на компьютере выбран языковой стандарт en.The label would show Saturday, October 11, 2014 01:50:24:765 PM if your computer were set to the en locale.

    Вы также можете указать формат hh:mm:ss.f или hh:mm:ss.ff, чтобы округлять значение времени до ближайшей десятой или сотой доли секунды.As an alternative, you can specify hh:mm:ss.f or hh:mm:ss.ff to round the time to the nearest tenth or hundredth of a second.

TimeValueTimeValue

Назовите элемент управления для ввода текста FinishedAt и задайте свойству Text метки такое значение функции:Name a text-input control FinishedAt, and set the Text property of a label to this function:

If(TimeValue(FinishedAt.Text)<TimeValue("5:00:00.000 PM"), "You made it!", "Too late!")If(TimeValue(FinishedAt.Text)<TimeValue("5:00:00.000 PM"), "You made it!", "Too late!")

  • Если ввести 4:59:59.999 PM в элемент управления FinishedAt, то метка отобразит "You made it!".If you type 4:59:59.999 PM into the FinishedAt control, the label shows "You made it!"
  • Если ввести 5:00:00.000 PM в элемент управления FinishedAt, то метка отобразит "Too late!".If you type 5:00:00.000 PM into the FinishedAt control, the label shows "Too late!"