YEAR (SSIS)

Gibt eine ganze Zahl zurück, die den datepart-Wert für die Jahresangabe in einem Datum darstellt.

Syntax

YEAR(date)

Argumente

  • date
    Ein Datum in einem beliebigen Datumsformat.

Ergebnistypen

DT_I4

Hinweise

YEAR gibt ein NULL-Ergebnis zurück, wenn das Argument NULL ist.

Ein Datumsliteral muss explizit in einen der date-Datentypen umgewandelt werden. Weitere Informationen finden Sie unter SQL Server Integration Services-Datentypen.

HinweisHinweis

Der Ausdruck wird nicht überprüft, wenn ein Datumsliteral explizit in einen der folgenden Datumsdatentypen umgewandelt wird: DT_DBTIMESTAMPOFFSET oder DT_DBTIMESTAMP2.

Die YEAR-Funktion entspricht bezüglich der Verwendung der DATEPART("Year", date)-Funktion, ist jedoch schneller.

Beispiele

In diesem Beispiel wird die Jahreszahl eines Datumsliterals zurückgegeben. Falls das Datum das Format mm/dd/yyyy aufweist, wird "2002" zurückgegeben.

YEAR((DT_DBTIMESTAMP)"11/23/2002")

In diesem Beispiel wird die ganze Zahl zurückgegeben, die das Jahr in der ModifiedDate-Spalte darstellt.

YEAR(ModifiedDate)

In diesem Beispiel wird die ganze Zahl zurückgegeben, die das Jahr des aktuellen Datums darstellt.

YEAR(GETDATE())