YEAR (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Gibt einen Integer zurück, der das Jahr des angegebenen Datums (date) darstellt.

Eine Übersicht über alle Datums- und Uhrzeitdatentypen und zugehörigen Funktionen für Transact-SQL finden Sie unter Datums- und Uhrzeitdatentypen und zugehörige Funktionen (Transact-SQL).

Transact-SQL-Syntaxkonventionen

Syntax

YEAR ( date )

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

date
Ein Ausdruck, der in einen der folgenden Werte aufgelöst werden kann: time, date, smalldatetime, datetime, datetime2 oder datetimeoffset. Bei dem date-Argument kann es sich um einen Ausdruck, einen Spaltenausdruck, eine benutzerdefinierte Variable oder ein Zeichenfolgenliteral handeln.

Rückgabetypen

int

Rückgabewert

YEAR gibt den gleichen Wert zurück wie DATEPART (year, date).

Wenn date nur einen Uhrzeitteil enthält, lautet der Rückgabewert 1900. Hierbei handelt es sich um das Basisjahr.

Beispiele

Die folgende Anweisung gibt 2010 zurück. Dies ist das Jahr.

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

Die folgende Anweisung gibt 1900, 1, 1 zurück. Das Argument für date ist die Zahl 0. 0 wird von SQL Server als 1. Januar 1900 interpretiert.

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

Beispiele: Azure Synapse Analytics und Analytics-Plattformsystem (PDW)

Die folgende Anweisung gibt 1900, 1, 1 zurück. Das Argument für date ist die Zahl 0. 0 wird von SQL Server als 1. Januar 1900 interpretiert.

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

Weitere Informationen

CAST und CONVERT (Transact-SQL)