YEAR (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Devuelve un entero que representa la parte del año del parámetro date especificado.

Para una introducción acerca de todos los tipos de datos y funciones de fecha y hora de Transact-SQL, vea Funciones de fecha y hora (Transact-SQL).

Convenciones de sintaxis de Transact-SQL

Sintaxis

YEAR ( date )

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

date
Es una expresión que se puede resolver en un valor time, date, smalldatetime, datetime, datetime2 o datetimeoffset. El argumento date puede ser una expresión, expresión de columna, variable definida por el usuario o literal de cadena.

Tipos de valor devuelto

int

Valor devuelto

YEAR devuelve el mismo valor que DATEPART (year, date).

Si date contiene únicamente una parte horaria, el valor devuelto es 1900, el año base.

Ejemplos

La siguiente instrucción devuelve 2010. Este número corresponde al año.

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

La siguiente instrucción devuelve 1900, 1, 1. El argumento para date es el número 0. SQL Server interpreta 0 como 1 de enero de 1900.

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

Ejemplos: Azure Synapse Analytics y Sistema de la plataforma de análisis (PDW)

La siguiente instrucción devuelve 1900, 1, 1. El argumento para date es el número 0. SQL Server interpreta 0 como 1 de enero de 1900.

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

Consulte también

CAST y CONVERT (Transact-SQL)