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);

См. также

Справочник