DATEPART (Transact-SQL)

Статья
04/26/2023

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure Azure Synapse Analytics AnalyticsPlatform System (PDW)

Эта функция возвращает целое число, представляющее указанную часть datepart заданного типа date.

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

DATEPART ( datepart , date )

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

datepart
Определенная часть аргумента date, для которого функция DATEPART вернет значение типа integer. В приведенной ниже таблице перечислены все допустимые аргументы datepart.

Примечание.

DATEPART не принимает эквивалентные переменные, определяемые пользователем, для аргументов datepart.

datepart	Abbreviations
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
Выражение, которое разрешается в один из следующих типов данных:

date
datetime
datetimeoffset
datetime2
smalldatetime
time

Для dateDATEPART будет принимать столбец выражения, выражение, строковый литерал или определяемую пользователем переменную. Во избежание неоднозначности используйте четырехзначную запись года. Сведения о двузначном обозначении года см. в статье Настройка параметра конфигурации сервера 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, всегда 00, а масштаб этого значения составляет 9.

.123456700

datepart	Возвращаемое значение
year, yyyy, yy	2007
quarter, qq, q	4
month, mm, m	10
dayofyear, dy, y	303
day, dd, d	30
week, wk, ww	44
weekday, dw	3
hour, hh	12
minute, n	15
second, ss, s	32
millisecond, ms	123
microsecond, mcs	123456
nanosecond, ns	123456700
tzoffset, tz	310
iso_week, isowk, isoww	44

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

Для week (wk, ww) или weekday (dw) datepart возвращаемое значение DATEPART зависит от значения, заданного функцией 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 -- ( Sunday )

SET DATEFIRST 7 (воскресенье). После задания DATEFIRST используйте предлагаемую инструкцию SQL для табличных значений datepart:

SELECT DATEPART(week, '2007-04-21 '), DATEPART(weekday, '2007-04-21 ')

SET DATEFIRST аргумент	нед. элементов	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. Каждая неделя приписывается тому году, в котором находится ее четверг. Например, первая неделя 2004 г. (2004W01) считается с понедельника 29 декабря 2003 г. по воскресенье 4 января 2004 г. Европейские страны или регионы обычно используют этот стиль нумерирования. Неевропейские страны и регионы обычно не используют его.

Примечание. Наибольшее число недель в году может составлять 52 или 53.

Система отсчета недель в разных странах и регионах может не совпадать со стандартом ISO. В таблице ниже представлено шесть возможных вариантов.

Первый день недели	Содержание первой недели года	Двойное присвоение недель	Применяется в:
Воскресенье	1 января, Первая суббота, 1–7 дней года	Да	Соединенные Штаты
Понедельник	1 января, Первое воскресенье, 1–7 дней года	Да	Большинство стран Европы, а также Великобритания
Понедельник	4 января, Первый четверг 4–7 дней года	No	ISO 8601, Норвегия и Швеция
Понедельник	7 января, Первый понедельник Семь дней года	No
Среда	1 января, Первый вторник, 1–7 дней года	Да
Суббота	1 января, Первая пятница, 1–7 дней года	Да

tzoffset

DATEPART возвращает значение tzoffset (tz) как количество минут (со знаком). В результате выполнения этой инструкции возвращается смещение часового пояса 310 минут:

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

Функция DATEPART отображает значение tzoffset описанным ниже образом.

Для datetimeoffset и datetime2 значение tzoffset возвращает временное смещение в минутах, причем для datetime2 смещение всегда равно 0 минут.
Для типов данных, которые могут быть неявно преобразованы в datetimeoffset или datetime2, функция DATEPART возвращает временное смещение в минутах. Для остальных типов даты и времени этого не происходит.
Для параметров любых других типов возвращается ошибка.

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

Для значения date типа smalldatetime функция DATEPART возвращает количество секунд 00.

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

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

Например, значение "год-месяц-день" по умолчанию для любого типа данных 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');

Если аргумент date указан как переменная или столбец таблицы и тип данных этой переменной или столбца не содержит указанной части datepart, функция DATEPART возвращает ошибку 9810. В этом примере переменная @t имеет тип данных time. Этот пример завершается ошибкой, потому что год даты не является допустимым для типа данных time:

DECLARE @t time = '12:10:30.123';   
SELECT DATEPART(year, @t);

Доли секунды

Эти инструкции демонстрируют, что функция DATEPART возвращает доли секунды:

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.

DATEPART неявно приводит строковые литералы в качестве типа datetime2 в SQL Server 2008 (10.0.x) и более поздних версий. Это означает, что DATENAME не поддерживает формат ГЧМ (год, число, месяц) при передаче даты в виде строки. Для использования формата ГЧМ (год, число, месяц) необходимо явно привести строку к типу datetime или smalldatetime.

Примеры

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

SELECT DATEPART(year, 0), DATEPART(month, 0), DATEPART(day, 0);  

-- Returns: 1900    1    1

В приведенном ниже примере возвращается часть даты 12/20/1974, представляющая день.

-- Uses AdventureWorks  
  
SELECT TOP(1) DATEPART (day,'12/20/1974') FROM dbo.DimCustomer;  

-- Returns: 20

В приведенном ниже примере возвращается часть даты 12/20/1974, представляющая год.

-- Uses AdventureWorks  
  
SELECT TOP(1) DATEPART (year,'12/20/1974') FROM dbo.DimCustomer;  

-- Returns: 1974

См. также

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