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

Функции Дата, Дата и время и Время

  • Статья

Применимо к: Приложениям Canvas Потокам рабочего стола Приложениям на основе моделей Power Pages Power Platform CLI

Преобразуют компоненты даты и времени в значение даты и времени.

Description

Функция Date преобразует отдельные значения Year (Год), Month (Месяц) и Day (День) в единое значение даты и времени. В качестве времени в этом значении указывается полночь.

  • Если значение аргумента Year находится в диапазоне от 0 до 1899 (включительно), то функция прибавляет это значение к числу 1900 и вычисляет год. 70 становится 1970.
  • Если значение аргумента Month меньше 1 или больше 12, то результат вычитает это значение или добавляет его от начала указанного года.
  • Если значение аргумента Day превышает количество дней в указанном месяце, то функция добавляет это значение к первому дню месяца и возвращает соответствующую дату из следующего месяца. Если значение аргумента Day меньше 1, то функция вычитает это значение, плюс 1 день, от первого дня указанного месяца.

Функция Время преобразует отдельные значения Час, Минута, Секунда и опционально Миллисекунда в единое значение дата/время. Результат не содержит связанной с ним даты.

Функция Дата и время объединяет функции Дата и Время в одну функцию, принимающую аргументы даты и времени и возвращающую значение даты/времени, содержащее компоненты даты и времени.

Ознакомьтесь с описанием функций DateValue, TimeValue и DateTimeValue для получения сведений о преобразовании строки в значение.

Ознакомьтесь также с дополнительными сведениями в статье о работе с датами и временем.

Синтаксис

Дата( Год, Месяц, День< а12>)

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

Время( Час, Минута, Секунда [, Миллисекунды ] )

  • Час - Обязательно. Количество часов, обычно в диапазоне от 0 (12:00 AM) до 23 (11:00 PM).
  • Минута - Обязательно. Количество минут, обычно в диапазоне от 0 до 59.
  • Второе - Обязательно. Количество секунд, обычно в диапазоне от 0 до 59.
  • Миллисекунды - Необязательно. Количество миллисекунд, обычно в диапазоне от 0 до 999.

ДатаВремя( Год, Месяц, День, Час, Минута, Секунда [, Миллисекунды ] )

  • Год - Обязательно. Числа больше 1899 интерпретируются как абсолютные (1980 интерпретируется как 1980), а числа в диапазоне от 0 до 1899 интерпретируются как относительные по отношению к 1900. (Например, 80 интерпретируется как 1980.)
  • Месяц - Обязательно. Число в диапазоне от 1 до 12.
  • День - Обязательно. Число в диапазоне от 1 до 31.
  • Час - Обязательно. Количество часов, обычно в диапазоне от 0 (12:00 AM) до 23 (11:00 PM)
  • Минута - Обязательно. Количество минут, обычно в диапазоне от 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) )

Время

Если пользователь ввел

  • 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" 
)

Дата/время

Если пользователь ввел

  • 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"
)