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.

Предыдущая
DATEADD
Следующая
DATETRUNC