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

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

  • Стаття

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

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

Опис

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

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

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

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

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

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

Синтаксис

Date( Year, Month, Day )

  • Year – обов’язковий аргумент. Числа, більші за 1899, інтерпретуються як абсолютні (1980 інтерпретується як 1980); числа в діапазоні від 0 до 1899 інтерпретуються як відносні до 1900. (Наприклад, 80 інтерпретується як 1980.)
  • Month – обов’язковий аргумент. Число в діапазоні від 1 до 12.
  • Day – обов’язковий аргумент. Число в діапазоні від 1 до 31.

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

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

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

  • Year – обов’язковий аргумент. Числа, більші за 1899, інтерпретуються як абсолютні (1980 інтерпретується як 1980); числа в діапазоні від 0 до 1899 інтерпретуються як відносні до 1900. (Наприклад, 80 інтерпретується як 1980.)
  • Month – обов’язковий аргумент. Число в діапазоні від 1 до 12.
  • Day – обов’язковий аргумент. Число в діапазоні від 1 до 31.
  • Hour – обов’язковий аргумент. Кількість годин, зазвичай у діапазоні від 0 (12:00) до 23 (23:00)
  • Minute – обов’язковий аргумент. Кількість хвилин, як правило, в діапазоні від 0 до 59.
  • Second – обов’язковий аргумент. Кількість секунд, зазвичай в діапазоні від 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"
)