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

  • Статья

Применимо к: приложениям на основе холста классическим потокам приложениям на основе модели интерфейсу командной строки Power Platform

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

Description

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

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

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

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

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

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

Синтаксис

Date( Год, Месяц, День )

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

Time( Час, Минута, Секунда [, Миллисекунда ] )

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

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

  • Год — обязательный аргумент. Числа больше 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"
)