YEAR (Transact-SQL)

  • Статья

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

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

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

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

Синтаксис

YEAR ( date )

Примечание.

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

Аргументы

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

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

int

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

Функция YEAR возвращает то же значение, что и функция DATEPART (year, date).

Если дата date содержит только компонент времени, возвращаемое значение равно 1900, базовому году.

Примеры

Следующая инструкция возвращает значение 2010. Порядковый номер года.

SELECT YEAR('2010-04-30T01:01:01.1234567-07:00');

Следующая инструкция возвращает значение 1900, 1, 1. В качестве значения аргумента date задается число 0. SQL Server интерпретируется 0 как 1 января 1900 г.

SELECT YEAR(0), MONTH(0), DAY(0);

Примеры: Azure Synapse Analytics и система платформы аналитики (PDW)

Следующая инструкция возвращает значение 1900, 1, 1. В качестве значения аргумента date задается число 0. SQL Server интерпретируется 0 как 1 января 1900 г.

SELECT TOP 1 YEAR(0), MONTH(0), DAY(0);

См. также

CAST и CONVERT (Transact-SQL)