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
, Файлы
, Google Sheets
, Microsoft SQL Server 2017 (14.0)
, MySQL 5.7
, Oracle Database 12c (12.1)
, PostgreSQL 9.3
, Яндекс Документы
, YDB
.