Функции работы с датами

Функции работы с датами
Статус разработки: Реализован

• Начальная страница
• Общее описание

Функции работы с датой и временем модифицируют внутреннее представление даты, получают ее различные части, получают текущую дату. Более подробно см. Дата и время.

Основные функции

Идентификатор	Статус	Тип	Визуальная	Параметры	Описание
CurDate, WorkingDate	Реализована	Функция		CurDate():<Текущая дата и время (DATE)>	Получение текущей даты и времени по системным часам компьютера.
Date	Реализована	Функция		Date():<Текущая дата и время (DATE)> Date(<Аргумент>):<Результат (DATE)> Date(<Год>,<Месяц>,<День>,<Час>,<Минута>,<Секунда>):<Результат (DATE)>	Получение текущей даты и времени по системным часам компьютера; превращение объекта в тип дата и время; создание даты из составляющих год, месяц, день с возможностью указать время.
GMTDate	Реализована	Функция		GMTDate():<Текущая дата и время по Гринвичу (DATE)>	Получение текущей даты и времени по системным часам компьютера с пересчетом по Гринвичскому меридиану.
FormatDate	Реализована	Функция		FormatDate(<Дата>,<Шаблон форматирования (STRING)>,<Язык форматирования (STRING)>):<Результат (STRING)>	Производит перекодировку даты и времени в строковой формат по указанному шаблону, используя указанный язык
AddYear	Реализована	Функция		AddYear(<Аргумент>,<Количество (INT)>=1):<Результат (DATE)>	Увеличение (уменьшение) даты на указанное количество лет. Число месяца может уменьшиться на единицу, если оригинальная дата содержала число 29 февраля и в результате операции дата указывает на невисокосный год.
AddMonth	Реализована	Функция		AddMonth(<Аргумент>,<Количество (INT)>=1):<Результат (DATE)>	Увеличение (уменьшение) даты на указанное количество месяцев. Число месяца может уменьшиться, если оригинальная дата указывала на число месяца большее, чем позволяет месяц результирующей даты.
AddDay	Реализована	Функция		AddDay(<Аргумент>,<Количество (INT)>=1):<Результат (DATE)>	Увеличение (уменьшение) даты на указанное количество дней
AddHour	Реализована	Функция		AddHour(<Аргумент>,<Количество (INT)>=1):<Результат (DATE)>	Увеличение (уменьшение) даты на указанное количество часов
AddMinute	Реализована	Функция		AddMinute(<Аргумент>,<Количество (INT)>=1):<Результат (DATE)>	Увеличение (уменьшение) даты на указанное количество минут
AddSecond	Реализована	Функция		AddSecond(<Аргумент>,<Количество (INT)>=1):<Результат (DATE)>	Увеличение (уменьшение) даты на указанное количество секунд
AddMillisecond	Реализована	Функция		AddMillisecond(<Аргумент>,<Количество (INT)>=1):<Результат (DATE)>	Увеличение (уменьшение) даты на указанное количество миллисекунд
BegOfDay	Реализована	Функция		BegOfDay(<Аргумент>):<Результат (DATE)>	Модифицирует время аргумента-даты, чтобы та указывала на начало дня, при этом день не меняется.
EndOfDay	Реализована	Функция		EndOfDay(<Аргумент>):<Результат (DATE)>	Модифицирует время аргумента-даты, чтобы время указывало на 23:59:59.999, при этом день не меняется.
BegOfMonth	Реализована	Функция		BegOfMonth(<Аргумент>):<Результат (DATE)>	Переводит дату на начало месяца, устанавливает время на 00:00:00.
EndOfMonth	Реализована	Функция		EndOfMonth(<Аргумент>):<Результат (DATE)>	Переводит дату на последний день месяца, устанавливает время на 00:00:00.
EndOfMonthT	Реализована	Функция		EndOfMonthT(<Аргумент>):<Результат (DATE)>	Переводит дату на последний день месяца, устанавливает время на 23:59:59.999.
BegOfQuarter	Реализована	Функция		BegOfQuarter(<Аргумент>):<Результат (DATE)>	Переводит дату на начало квартала, устанавливает время на 00:00:00.
EndOfQuarter	Реализована	Функция		EndOfQuarter(<Аргумент>):<Результат (DATE)>	Переводит дату на конец квартала, устанавливает время на 00:00:00.
EndOfQuarterT	Реализована	Функция		EndOfQuarterT(<Аргумент>):<Результат (DATE)>	Переводит дату на конец квартала, устанавливает время на 23:59:59.999.
BegOfYear	Реализована	Функция		BegOfYear(<Аргумент>):<Результат (DATE)>	Переводит дату на начало года, устанавливает время на 00:00:00.
EndOfYear	Реализована	Функция		EndOfYear(<Аргумент>):<Результат (DATE)>	Переводит дату на конец года, устанавливает время на 00:00:00.
EndOfYearT	Реализована	Функция		EndOfYearT(<Аргумент>):<Результат (DATE)>	Переводит дату на конец года, устанавливает время на 23:59:59.999.
BegOfWeek	Реализована	Функция		BegOfWeek(<Аргумент>):<Результат (DATE)>	Переводит дату на начало недели, устанавливает время на 00:00:00.
EndOfWeek	Реализована	Функция		EndOfWeek(<Аргумент>):<Результат (DATE)>	Переводит дату на конец недели, устанавливает время на 00:00:00.
EndOfWeekT	Реализована	Функция		EndOfWeekT(<Аргумент>):<Результат (DATE)>	Переводит дату на конец недели, устанавливает время на 23:59:59.999.
GetYear	Реализована	Функция		GetYear(<Аргумент>):<Результат (INT)>	Возвращает год даты в полной 4 циферной нотации (2020)
GetQuarter	Реализована	Функция		GetQuarter(<Аргумент>):<Результат (INT)>	Возвращает номер квартала даты (первый квартал имеет значение 1)
GetMonth	Реализована	Функция		GetMonth(<Аргумент>):<Результат (INT)>	Возвращает номер месяца даты
GetDay	Реализована	Функция		GetDay(<Аргумент>):<Результат (INT)>	Возвращает номер дня месяца даты
GetHour	Реализована	Функция		GetHour(<Аргумент>):<Результат (INT)>	Возвращает номер часа времени даты. Используется 24-часовой формат времени.
GetMinute	Реализована	Функция		GetMinute(<Аргумент>):<Результат (INT)>	Возвращает номер минуты времени даты.
GetSecond	Реализована	Функция		GetSecond(<Аргумент>):<Результат (INT)>	Возвращает номер секунды времени даты.
GetMillisecond	Реализована	Функция		GetMillisecond(<Аргумент>):<Результат (INT)>	Возвращает номер миллисекунды времени даты.
WeekOfYear	Реализована	Функция		WeekOfYear(<Аргумент>):<Результат (INT)>	Возвращает номер недели в году даты. Для дат в конца года, которые могут принадлежать неделям начала года, используется номер последней недели года.
DayOfYear	Реализована	Функция		DayOfYear(<Аргумент>):<Результат (INT)>	Возвращает номер дня года даты.
DayOfWeek	Реализована	Функция		DayOfWeek(<Аргумент>):<Результат (INT)>	Возвращает номер дня недели даты. Неделя начинается с понедельника и заканчивается воскресеньем.
GetPeriod	Реализована	Функция		GetPeriod(<Дата 1>,<Дата 2>,<Режим (INT)>=0):<Результат (NUMBER)>	Получает величину времени, прошедшего с даты первого аргумента до даты второго аргумента, выраженную в указанных единицах.
GetPeriodMs	Реализована	Функция		GetPeriodMs(<Аргумент>):<Количество миллисекунд (INT)>	Получает количество миллисекунд, прошедших с даты аргумента до текущего момента.
CurTime	Реализована	Функция		CurTime(<Часы (INT)>,<Минуты (INT)>,<Секунды (INT)>,<Миллисекунды (INT)>):<Текущее время (STRING)>	Получает текущее время в виде строки, либо часы, минуты, секунды и миллисекунды текущего времени в отдельные переменные.
GetTime	Реализована	Функция		GetTime(<Аргумент>,<Показывать миллисекунды (INT)>=0):<Время аргумента (STRING)>	Получает время первого аргумента в виде строки, по желанию показывая в этом времени миллисекунды.
CurHour	Реализована	Функция		CurHour():<Текущий час (INT)>	Получает текущий час. Используется 24-часовой формат времени.
CurMinute	Реализована	Функция		CurMinute():<Текущая минута (INT)>	Получает текущую минуту.
CurSecond	Реализована	Функция		CurSecond():<Текущая секунда (INT)>	Получает текущую секунду.
SetTime	Планируется	Функция		SetTime(<Аргумент>,<Часы (INT)>,<Минуты (INT)>,<Секунды (INT)>,<Миллисекунды (INT)>):<Результат (DATE)>	Устанавливает время аргумента. Пропущенные поля для времени изменены не будут.