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Строка

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

    Примечание

    Значения аргументов (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