DATEPART

Синтаксис

DATEPART( datetime, unit [ , firstday ] )

Описание

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

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

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

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

Типы аргументов:

• datetime — Дата | Дата и время
• unit — Строка
• firstday — Строка

Возвращаемый тип: Целое число

Примеры

DATEPART(#2019-01-23#, "year") = 2019

DATEPART(#2019-01-23#, "month") = 1

DATEPART(#2019-01-23#, "day") = 23

DATEPART(#2019-01-23 11:47:07#, "hour") = 11

DATEPART(#2019-01-23 11:47:07#, "minute") = 47

DATEPART(#2019-01-23 11:47:07#, "second") = 7

DATEPART(#1971-01-14 01:02:03#, "dayofweek") = 4

DATEPART(#1971-01-14 01:02:03#, "dayofweek", "wed") = 2

Поддержка источников данных

Материализованный датасет, ClickHouse 1.1, Microsoft SQL Server 2017 (14.0), MySQL 5.6, Oracle Database 12c (12.1), PostgreSQL 9.3.