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—Строка
Возвращаемый тип: Целое число
Примечание
Значения аргументов (firstday) должны быть константами.
Примеры
Пример с датой
Формулы:
- Date:
[Date]; - Year:
DATEPART([Date], "year"); - Month:
DATEPART([Date], "month"); - Day:
DATEPART([Date], "day"); - DayOfWeek:
DATEPART([Date], "dayofweek"); - DOW:
DATEPART([Date], "dow").
| Date | Year | Month | Day | DayOfWeek | DOW |
|---|---|---|---|---|---|
2014-10-06 | 2014 | 10 | 6 | 1 | 1 |
2014-10-07 | 2014 | 10 | 7 | 2 | 2 |
2017-03-08 | 2017 | 3 | 8 | 3 | 3 |
2024-02-12 | 2024 | 2 | 12 | 1 | 1 |
Пример с заданным первым днем недели
Формулы:
- Date:
[Date]; - DOW:
DATEPART([Date], "dow"); - DOW sun:
DATEPART([Date], "dow", "sun"); - DOW Monday:
DATEPART([Date], "dow", "Monday"); - DOW wed:
DATEPART([Date], "dow", "wed").
| Date | DOW | DOW sun | DOW Monday | DOW wed |
|---|---|---|---|---|
2014-10-06 | 1 | 2 | 1 | 6 |
2014-10-07 | 2 | 3 | 2 | 7 |
2017-03-08 | 3 | 4 | 3 | 1 |
2024-02-12 | 1 | 2 | 1 | 6 |
Пример с датой и временем
Формулы:
- DateTime:
[DateTime]; - Year:
DATEPART([DateTime], "year"); - Month:
DATEPART([DateTime], "month"); - Day:
DATEPART([DateTime], "day"); - Hour:
DATEPART([DateTime], "hour"); - Minute:
DATEPART([DateTime], "minute"); - Second:
DATEPART([DateTime], "second").
| DateTime | Year | Month | Day | Hour | Minute | Second |
|---|---|---|---|---|---|---|
2014-10-06T07:45:12 | 2014 | 10 | 6 | 7 | 45 | 12 |
2014-10-07T11:10:15 | 2014 | 10 | 7 | 11 | 10 | 15 |
2017-03-08T23:59:59 | 2017 | 3 | 8 | 23 | 59 | 59 |
2024-02-12T07:40:33 | 2024 | 2 | 12 | 7 | 40 | 33 |
Поддержка источников данных
ClickHouse 21.8, Microsoft SQL Server 2017 (14.0), MySQL 5.7, Oracle Database 12c (12.1), PostgreSQL 9.3, YDB.