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

Застосовується до: програм Canvas Потоків робочого столу Програм, Power Pages 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"
)