Функции даты и времени

DATEADD

Синтаксис:DATEADD( datetime, unit, number )

Возвращает дату, полученную в результате добавления unit в количестве number к указанной дате datetime.

Аргумент number задается целым числом. Может принимать отрицательные значения. Аргумент unit принимает следующие значения:

• "year" — год,
• "month" — месяц,
• "day" — день,
• "hour" — час,
• "minute" — минута,
• "second" — секунда.

DATEPART

Синтаксис:DATEPART( datetime, unit [ , firstday ] )

Возвращает часть даты в виде целого числа.

В зависимости от аргумента unit возвращает следующие значения:

• "year" — номер года (см. YEAR),
• "month" — номер месяца в году (см. MONTH),
• "week" — номер недели в году по ISO 8601 (см. WEEK),
• "dayofweek", "dow" — номер дня недели (см. DAYOFWEEK),
• "day" — номер дня в месяце (см. DAY),
• "hour" — номер часа в дне (см. HOUR),
• "minute" — номер минуты в часе (см. MINUTE),
• "second" — номер секунды в минуте (см. SECOND).

Если выбран "dayofweek", то дополнительным параметром firstday можно задать, какой день недели считать первым — по умолчанию это понедельник. Более подробно об этом параметре смотрите в описании функции DAYOFWEEK.

DATETRUNC

Синтаксис:DATETRUNC( datetime, unit [ , number ] )

Возвращает дату, округленную по аргументу unit.

Поддерживаемые значения unit:

• "second",
• "minute",
• "hour",
• "day",
• "week",
• "month",
• "year".

DAY

Синтаксис:DAY( datetime )

Возвращает номер дня в месяце в указанной дате datetime.

DAYOFWEEK

Синтаксис:DAYOFWEEK( datetime [ , firstday ] )

Возвращает день недели в соответствии с ISO 8601.

• Понедельник — 1;
• Воскресенье — 7.

Если указан дополнительный параметр firstday, то этот день считается первым в неделе. Допустимые значения:

• "Monday", "Mon" — понедельник;
• "Tuesday", "Tue" — вторник;
• "Wednesday", "Wed" — среда;
• "Thursday", "Thu" — четверг;
• "Friday", "Fri" — пятница;
• "Saturday", "Sat" — суббота;
• "Sunday", "Sun" — воскресенье.

HOUR

Синтаксис:HOUR( datetime )

Возвращает номер часа в дне в указанной дате и времени datetime. При указании даты без времени возвращает 0.

MINUTE

Синтаксис:MINUTE( datetime )

Возвращает номер минуты в часе в указанной дате datetime. При указании даты без времени возвращает 0.

MONTH

Синтаксис:MONTH( datetime )

Возвращает номер месяца в году в указанной дате datetime.

NOW

Синтаксис:NOW()

Возвращает текущую дату и время, в зависимости от источника данных и типа соединения:

• при прямом подключении функция возвращает серверную дату и время источника;
• при материализации функция возвращает дату и время по Московскому времени.

SECOND

Синтаксис:SECOND( datetime )

Возвращает номер секунды в минуте в указанной дате datetime. При указании даты без времени возвращает 0.

TODAY

Синтаксис:TODAY()

Возвращает текущую дату, в зависимости от источника данных и типа соединения:

• при прямом подключении функция возвращает серверную дату и время источника;
• при материализации функция возвращает дату и время по Московскому времени.

WEEK

Синтаксис:WEEK( value )

Возвращает номер недели в соответствии с ISO 8601. Первой считается неделя, которая содержит первый четверг года и 4.01.

YEAR

Синтаксис:YEAR( datetime )

Возвращает номер года в указанной дате datetime.