Date

From SunFlurry wiki
Jump to: navigation, search
  Date (Функции работы с датами)
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в дату или/и число
Визуальность:Нет

Функция имеет троякое действие:

  • Получение текущей даты и времени по системным часам компьютера (если аргументы отстствуют)
  • Превращение объекта в тип дата и время (указан один аргумент)
  • Создание даты из составляющих год, месяц, день с возможностью указать время (указано более двух аргументов). Если аргументы не задают корректную дату, в результате работы функции будет возвращена пустая дата.

Синтаксис

Date():<Текущая дата и время (DATE)>
Date(<Аргумент>):<Результат (DATE)>
Date(<Год>,<Месяц>,<День>,<Час>,<Минута>,<Секунда>):<Результат (DATE)>

Аргументы

  • <Аргумент> - Значение, которое необходимо сконвертировать в дату и время. Может быть строкой либо датой и временем. Для подробностей см. статью Дата и время. Если данный аргумент является числом или пустым значением, будет возвращена пустая дата.
  • <Год> - Год создаваемой даты, может быть укороченным (состоять из 2 цифр) и полным (состоять из 4 цифр).
  • <Месяц> - Месяц создаваемой даты (число в диапазоне 1..12)
  • <День> - День создаваемой даты (число в диапазоне 1..31)
  • <Час> - (необязательный аргумент) Час создаваемой даты (число в диапазоне 0..23)
  • <Минута> - (необязательный аргумент) Минута создаваемой даты (число в диапазоне 0..59)
  • <Секунда> - (необязательный аргумент) Секунда создаваемой даты (число в диапазоне 0..59)

Возвращаемое значение

Возвращает значение типа Дата и время.

Примеры

Message(Date());
//Будет выведена текущая дата

Message(Date("12.12.2021 15:00"));
//Будет выведено '12.12.2021' (время выводится при форматировании функцией FormatDate)

Message(Date(2021,12,12,15,00));
//Будет выведено '12.12.2021' (время выводится при форматировании функцией FormatDate)