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

Функції «Дата», «ДатаЧас» і «Час»

  • Стаття

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

Перетворення компонентів дати й часу на значення дати/часу.

Опис

Функція Date перетворює окремі значення року, місяця та дня на значення дати/часу. Частина, що відноситься до часу, відображається як північ.

  • Якщо значення року знаходиться в діапазоні від 0 до 1899 (включно), функція додає це значення до 1900, щоб обчислити рік. 70 стає 1970 роком .
  • Якщо значення місяця менше 1 або більше 12, у результаті така кількість місяців віднімається від початку вказаного року або додається до нього.
  • Якщо значення дня перевищує кількість днів у вказаному місяці, функція додає таку кількість днів до першого дня місяця і повертає відповідну дату з наступного місяця. Якщо значення дня менше 1, функція віднімає таку кількість днів (плюс 1) від першого дня вказаного місяця.

Функція «Час » перетворює окремі значення «Година», «Хвилина», «Секунда» та, за бажанням, у мілісекунди на значення «Дата й час». Результат не має пов’язаної з ним дати.

Функція DateTime об’єднує функції «Дата » та «Час » в одну функцію, приймаючи аргументи дати та часу та повертаючи значення дати/часу, яке має компоненти дати та часу.

Відомості про перетворення рядка в значення див. в статтях, присвячених функціям DateValue, TimeValue та DateTimeValue.

Додаткова інформація також міститься в статті про роботу з датами й часом.

Синтаксис

Дата ( рік, місяць, день )

  • Рік - обов’язковий. Числа, більші за 1899, інтерпретуються як абсолютні (1980 інтерпретується як 1980); числа в діапазоні від 0 до 1899 інтерпретуються як відносні до 1900. (Наприклад, 80 інтерпретується як 1980.)
  • Місяць - обов’язковий. Число в діапазоні від 1 до 12.
  • День - обов’язковий. Число в діапазоні від 1 до 31.

Час ( година, хвилина, секунда [,мілісекунди ] )

  • Година - обов’язкова. Кількість годин, зазвичай в діапазоні від 0 (12:00) до 23 (23:00).
  • Хвилина - обов’язкова. Кількість хвилин, зазвичай знаходиться в діапазоні від 0 до 59.
  • Друге - обов’язково. Кількість секунд, зазвичай знаходиться в діапазоні від 0 до 59.
  • Мілісекунди - необов’язково. Кількість мілісекунд, зазвичай знаходиться в діапазоні від 0 до 999.

DateTime( Рік, Місяць, День, Година, Хвилина, Секунда [,Мілісекунди ] )

  • Рік - обов’язковий. Числа, більші за 1899, інтерпретуються як абсолютні (1980 інтерпретується як 1980); числа в діапазоні від 0 до 1899 інтерпретуються як відносні до 1900. (Наприклад, 80 інтерпретується як 1980.)
  • Місяць - обов’язковий. Число в діапазоні від 1 до 12.
  • День - обов’язковий. Число в діапазоні від 1 до 31.
  • Година - обов’язкова. Кількість годин, зазвичай в діапазоні від 0 (12:00) до 23 (23:00)
  • Хвилина - обов’язкова. Кількість хвилин, зазвичай знаходиться в діапазоні від 0 до 59.
  • Друге - обов’язково. Кількість секунд, зазвичай знаходиться в діапазоні від 0 до 59.
  • Мілісекунди - необов’язково. Кількість мілісекунд, зазвичай знаходиться в діапазоні від 0 до 999.

Приклади

датою

Якщо користувач ввів текст

  • 1979 в елементі керування текстовим введенням під назвою HireYear
  • 3 у елементі керування текстового введення під назвою HireMonth
  • 17 у елементі керування текстового введення під назвою HireDay

Ця формула поверне: 3/17/1979

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

Час

Якщо користувач ввів текст

  • 14 у елементі керування текстового введення з іменем BirthHour
  • 50 у елементі керування текстового введення під назвою BirthMinute
  • 24 у елементі керування текстового введення з іменем BirthSecond

Ця формула поверне: 02:50:24 P

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

DateTime

Якщо користувач ввів текст

  • 2023 у елементі керування текстового введення під назвою EclipseYear
  • 10 в елементі керування текстового введення з іменем EclipseMonth
  • 28 в елементі управління текстового введення з іменем EclipseDate
  • 13 в елементі керування текстового введення під назвою EclipseHour
  • 14 в елементі керування текстового введення з іменем EclipseMinute
  • 5 в елементі керування текстового введення з іменем EclipseSecond
  • 231 в елементі керування введення тексту з іменем EclipseMillisecond

Ця формула поверне: 10/28/23 01:14:05.231 PM

Text(
    DateTime(Value(EclipseYear.Text), Value(EclipseMonth.Text), Value(EclipseDate.Text), 
        Value(EclipseHour.Text), Value(EclipseMinute.Text), 
        Value(EclipseSecond.Text), Value(EclipseSecond.Millisecond)
    ), 
    "yy/mm/dd hh:mm:ss.000 AM/PM"
)