Функции работы с датами
| Функции работы с датами | |||
|---|---|---|---|
| |||
Функции работы с датой и временем модифицируют внутреннее представление даты, получают ее различные части, получают текущую дату. Более подробно см. Дата и время.
Основные функции
| Идентификатор | Статус | Тип | Визуальная | Параметры | Описание |
|---|---|---|---|---|---|
| CurDate, WorkingDate | Реализована | Функция | CurDate():<Текущая дата и время (DATE)> | Получение текущей даты и времени по системным часам компьютера. | |
| Date | Реализована | Функция | Date():<Текущая дата и время (DATE)> Date(<Аргумент>):<Результат (DATE)> Date(<Год>,<Месяц>,<День>,<Час>,<Минута>,<Секунда>):<Результат (DATE)> |
Получение текущей даты и времени по системным часам компьютера; превращение объекта в тип дата и время; создание даты из составляющих год, месяц, день с возможностью указать время. | |
| GMTDate | Реализована | Функция | GMTDate():<Текущая дата и время по Гринвичу (DATE)> | Получение текущей даты и времени по системным часам компьютера с пересчетом по Гринвичскому меридиану. | |
| FormatDate | Реализована | Функция | FormatDate(<Дата>,<Шаблон форматирования>,<Язык форматирования (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)> | Устанавливает время аргумента. Пропущенные поля для времени изменены не будут. |
