Поделиться через


YEAR (Transact-SQL)

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

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

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

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

Синтаксис

YEAR ( date )  

Аргументы

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)