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.

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

• 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, PostgreSQL 9.3.