Функции Date и Time в PowerAppsDate and Time functions in PowerApps

Преобразуют компоненты даты и времени в значение даты и времени.Converts date and time components to a date/time value.

ОписаниеDescription

Функция Date преобразует отдельные значения Year (Год), Month (Месяц) и Day (День) в единое значение даты и времени.The Date function converts individual Year, Month, and Day values to a Date/Time value. В качестве времени в этом значении указывается полночь.The time portion is midnight.

  • Если значение аргумента Year находится в диапазоне от 0 до 1899 (включительно), то функция прибавляет это значение к числу 1900 и вычисляет год.If Year is between 0 and 1899 (inclusive), the function adds that value to 1900 to calculate the year. 70 превращается в 1970.70 becomes 1970.
  • Если значение аргумента Month меньше 1 или больше 12, то результат вычитает это значение или добавляет его от начала указанного года.If Month is less than 1 or more than 12, the result subtracts or adds that many months from the beginning of the specified year.
  • Если значение аргумента Day превышает количество дней в указанном месяце, то функция добавляет это значение к первому дню месяца и возвращает соответствующую дату из следующего месяца.If Day is greater than the number of days in the specified month, the function adds that many days to the first day of the month and returns the corresponding date from a subsequent month. Если значение аргумента Day меньше 1, то функция вычитает это значение, плюс 1 день, от первого дня указанного месяца.If Day is less than 1, the function subtracts that many days, plus 1, from the first day of the specified month.

Функция Time преобразует отдельные значения Hour (Час), Minute (Минута) и Second (Секунда) в единое значение даты и времени.The Time function converts individual Hour, Minute, and Second values to a Date/Time value. Результат не содержит связанной с ним даты.The result has no date associated with it.

Ознакомьтесь с описанием функций DateValue, TimeValue и DateTimeValue для получения сведений о преобразовании строки в значение.See the DateValue, TimeValue, and DateTimeValue functions for information about how to convert a string to a value.

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

СинтаксисSyntax

Date( Год, Месяц, День )Date( Year, Month, Day )

  • Год — обязательный аргумент.Year - Required. Числа больше 1899 интерпретируются как абсолютные (1980 интерпретируется как 1980), а числа в диапазоне от 0 до 1899 интерпретируются как относительные по отношению к 1900.Numbers greater than 1899 are interpreted as absolute (1980 is interpreted as 1980); numbers that range from 0 to 1899 are interpreted as relative to 1900. (Например, 80 интерпретируется как 1980.)(For example, 80 is interpreted as 1980.)
  • Месяц — обязательный аргумент.Month - Required. Число в диапазоне от 1 до 12.A number that ranges from 1 to 12.
  • День — обязательный аргумент.Day - Required. Число в диапазоне от 1 до 31.A number that ranges from 1 to 31.

Time( Часы, Минуты, Секунды )Time( Hour, Minute, Second )

  • Часы — обязательный аргумент.Hour - Required. Число в диапазоне от 0 (12:00 AM) до 23 (11:00 PM).A number that ranges from 0 (12:00 AM) to 23 (11:00 PM).
  • Минуты — обязательный аргумент.Minute - Required. Число в диапазоне от 0 до 59.A number that ranges from 0 to 59.
  • Секунды — обязательный аргумент.Second - Required. Число в диапазоне от 0 до 59.A number that ranges from 0 to 59.

ПримерыExamples

ДатаDate

Если пользователь ввел 1979 в элемент управления для ввода текста с именем HireYear, а также ввел 3 — в HireMonth и 17 — в HireDay, то эта функция должна вернуть значение 3/17/1979:If a user typed 1979 in a text-input control named HireYear, 3 in a text-input control named HireMonth, and 17 in a text-input control named HireDay, this function would return 3/17/1979:

Date(Value(HireYear.Text), Value(HireMonth.Text), Value(HireDay.Text))Date(Value(HireYear.Text), Value(HireMonth.Text), Value(HireDay.Text))

TimeTime

Если пользователь ввел 14 в элемент управления для ввода текста с именем BirthHour, а также ввел 50 — в BirthMinute и 24 — в BirthSecond, то эта функция должна вернуть значение 02:50:24 p.If a user typed 14 in a text-input control named BirthHour, 50 in a text-input control named BirthMinute, and 24 in a text-input control named BirthSecond, this function would return 02:50:24 p.

Text(Time(Value(BirthHour.Text), Value(BirthMinute.Text), Value(BirthSecond.Text)), "hh:mm:ss a/p")Text(Time(Value(BirthHour.Text), Value(BirthMinute.Text), Value(BirthSecond.Text)), "hh:mm:ss a/p")