YEAR (Transact-SQL)

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

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

Синтаксические обозначения Transact-SQL

Синтаксис

YEAR ( date )

Аргументы

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

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

int

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

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

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

Примеры

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

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

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

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

См. также

Справочник

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