Date, DateTimeі Time функції

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

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

Опис

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

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

Функція Time перетворює окремі значення Години, Хвилини, Секунди та Мілісекунди на Dateзначення /Time . Результат не має пов’язаної з ним дати.

Функція DateTime об'єднує Date функції та Time функції в одну функцію, беручи як аргументи дати, так і часу та повертаючи Dateзначення /Time , яке має як компоненти дати, так і часу.

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

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

Синтаксис

Date( Рік, Місяць, День )

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

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

  • Година - обов’язкова. Кількість годин, зазвичай в діапазоні від 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.

Приклади

Date

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

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

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

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

Time

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

  • 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"
)
  • Last updated on