• Статья

DATEPART (Transact-SQL)

Возвращает целое число, представляющее указанный компонент datepart указанной даты date.

Обзор всех типов данных и функций даты и времени в языке Transact-SQL см. в разделе Функции даты и времени (Transact-SQL). Сведения и примеры, относящиеся к типам данным и функциям даты и времени, см. в разделе Использование данных даты и времени.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

DATEPART ( datepart , date )

Аргументы

  • datepart
    Часть переменной типа date (значение даты или времени), имеющая значение типа integer. В следующей таблице перечислены все допустимые аргументы datepart. Эквивалентные переменные, определяемые пользователем, являются недопустимыми.

    datepart

    Сокращения

    year

    yy, yyyy

    quarter

    qq, q

    month

    mm, m

    dayofyear

    dy, y

    day

    dd, d

    week

    wk, ww

    weekday

    dw

    hour

    hh

    minute

    mi, n

    second

    ss, s

    millisecond

    ms

    microsecond

    mcs

    nanosecond

    ns

    TZoffset

    tz

    ISO_WEEK

    isowk, isoww

  • date
    Выражение, которое можно привести к значению типа time, date, smalldatetime, datetime, datetime2 или datetimeoffset. Параметр date может быть выражением, выражением столбца, определяемой пользователем переменной или строковым литералом.

    Во избежание неоднозначности используйте четырехзначную запись года. Сведения об обозначении года двумя цифрами см. в разделе Параметр two digit year cutoff.

Тип возвращаемых данных

int

Возвращаемое значение

Каждое выражение datepart и его краткие формы возвращают одно и то же значение.

Возвращаемое значение зависит от языка среды, задаваемого инструкцией SET LANGUAGE, и от языка, используемого по умолчанию для имени входа. Если значение date является строковым литералом для определенных форматов, то возвращаемое значение зависит от формата, указанного с помощью SET DATEFORMAT. Инструкция SET DATEFORMAT не влияет на возвращаемое значение, если дата представляется выражением столбца типа данных даты или времени.

Ниже представлена таблица соответствия аргументов функции datepart и значений, возвращенных выражением SELECT DATEPART(datepart,'2007-10-30 12:15:32.1234567 +05:10'). Аргумент функции date имеет тип datetimeoffset(7). Масштаб значения, возвращаемого функцией nanoseconddatepart, составляет 9 (.123456700). При этом два последних значения всегда имеют значение 00.

datepart

Возвращаемое значение

year, yyyy, yy

2007

quarter, qq, q

4

month, mm, m

10

dayofyear, dy, y

303

day, dd, d

30

week, wk, ww

45

weekday, dw

1

hour, hh

12

minute, n

15

second, ss, s

32

millisecond, ms

123

microsecond, mcs

123456

nanosecond, ns

123456700

TZoffset, tz

310

Аргументы функции datepart, содержащие информацию о номере недели и дня

Когда переменная datepart содержит значение week (wk, ww) или weekday (dw), то тип возвращаемого значения определяется установками функции SET DATEFIRST.

1 января любого года определяет начальное число для раздела даты weekdatepart, например: DATEPART (wk, 'Jan 1, xxxx') = 1, где xxxx ― любой год.

Ниже представлена таблица возвращаемых значений параметров week и weekdaydatepart даты «21.04.2007» с каждым аргументом функции SET DATEFIRST. 1 января 2007 г. — понедельник. 21 апреля 2007 г. — суббота. SET DATEFIRST 7, воскресенье задается по умолчанию для региональных настроек «Английский (США)».

SET DATEFIRST

аргумент

week

возвращаемое

weekday

возвращаемое

1

16

6

2

17

5

3

17

4

4

17

3

5

17

2

6

17

1

7

16

7

Аргументы функции datepart, отображающие год, месяц и день даты

Значения, возвращаемые в результате выполнения команд DATEPART (year, date), DATEPART (month, date) и DATEPART (day, date), совпадают с результатами выполнения функций YEAR, MONTH и DAY, соответственно.

ISO_WEEK datepart

Стандарт ISO 8601 включает в себя систему отсчета дней и недель ISO. Каждая неделя приписывается тому году, в котором находится ее четверг. Например, 1-я неделя 2004 г. (2004W01) считается с понедельника 29 декабря 2003 г. по воскресенье 4 января 2004 г. Наибольшее число недель в году может составлять 52 или 53. Этот стиль нумерации обычно используется в странах и регионах Европы, но редко в других странах.

Система отсчета недель в разных странах и регионах может не совпадать со стандартом ISO. Как показано в следующей таблице, существует как минимум шесть методов отсчета:

Первый день недели

Содержание первой недели года

Двойное присвоение недель

Применяется в:

Воскресенье

1 января,

Первая суббота,

1–7 дней года

Да

США

Понедельник

1 января,

Первое воскресенье,

1–7 дней года

Да

Большинство стран Европы, а также Великобритания

Понедельник

4 января,

Первый четверг

4–7 дней года

Нет

ISO 8601, Норвегия и Швеция

Понедельник

7 января,

Первый понедельник

7 дней года

Нет

Среда

1 января,

Первый вторник,

1–7 дней года

Да

Суббота

1 января,

Первая пятница,

1–7 дней года

Да

TZoffset

Значение переменной TZoffset (tz) возвращает количество минут (со знаком). В результате выполнения представленной ниже инструкции выдается значение временного смещения 310 минут.

SELECT DATEPART (TZoffset, 2007-05-10  00:00:01.1234567 +05:10);

Если аргумент datepart содержит переменную TZoffset (tz), а аргумент date имеет тип, отличный от datetimeoffset, возвращается значение NULL.

Аргумент даты типа smalldatetime

Если аргумент date имеет тип smalldatetime, для секунд возвращается значение 00.

Возвращается значение по умолчанию для аргумента функции datepart, который отличен от даты

Если тип данных аргумента date не содержит указанной части datepart, будет возвращаться значение по умолчанию для этой части datepart.

Например, формат по умолчанию «год-месяц-день» для всех типов данных date представляет 1900-01-01. Следующая инструкция содержит аргументы частей дат для datepart, аргумент времени для date и возвращает 1900, 1, 1, 1, 2.

SELECT DATEPART(year, '12:10:30.123')
    ,DATEPART(month, '12:10:30.123')
    ,DATEPART(day, '12:10:30.123')
    ,DATEPART(dayofyear, '12:10:30.123')
    ,DATEPART(weekday, '12:10:30.123');

По умолчанию формат «час-минуты-секунды» для типов данных time представляет 00:00:00. Следующая инструкция содержит аргументы частей времени для datepart, аргумент даты для date и возвращает 0, 0, 0.

SELECT DATEPART(hour, '2007-06-01')
    ,DATEPART(minute, '2007-06-01')
    ,DATEPART(second, '2007-06-01');

Доли секунды

Отображение долей секунд производится, как показано в следующих инструкциях:

SELECT DATEPART(millisecond, '00:00:01.1234567'); -- Returns 123
SELECT DATEPART(microsecond, '00:00:01.1234567'); -- Returns 123456
SELECT DATEPART(nanosecond,  '00:00:01.1234567'); -- Returns 123456700

Замечания

Функция DATEPART может использоваться в предложениях WHERE, HAVING, GROUP BY и ORDER BY, а также при составлении списка выбора. В SQL Server 2008 DATEPART неявно приводит строковые литералы к типу datetime2. Это означает, что DATEPART больше не поддерживает формат «гдм», где дата передается в качестве строки. Необходимо явно привести строку в тип datetime или smalldatetime для использования формата «гдм».

Примеры

В ходе выполнения представленного ниже примера производится отображение значения базового года отсчета. Значение базового года используется при расчетах, связанных с датами. В следующем примере дата указана как число. Обратите внимание на то, что SQL Server интерпретирует 0 как 1 января 1900 г. 

SELECT DATEPART(year, 0), DATEPART(month, 0), DATEPART(day, 0);
-- Returns: 1900    1    1 */

См. также

Справочник

Функции CAST и CONVERT (Transact-SQL)