Wenn zwei Daten eingegeben werden, liefert diese Funktion eine Ganzzahl, die die Anzahl der Jahre zwischen den beiden Tagen darstellt. Es wird jedoch empfohlen, stattdessen die DATEDIFF-Funktion zu verwenden. Weitere Hinweise finden Sie unter DATEDIFF-Funktion [Datum und Uhrzeit].

Wenn ein Datum eingegeben wird, gibt das System die Jahreszahl aus. Es wird jedoch empfohlen, stattdessen die DATEPART-Funktion zu verwenden. Weitere Hinweise finden Sie unter DATEPART-Funktion [Datum und Uhrzeit].

Wenn ein Datum und eine Ganzzahl eingegeben werden, fügt die Funktion die mit der Ganzzahl ausgedrückte Anzahl der Jahre zum angegebenen Datum hinzu. Es wird jedoch empfohlen, stattdessen die DATEADD-Funktion zu verwenden. Weitere Hinweise finden Sie unter DATEADD-Funktion [Datum und Uhrzeit].

Syntax 1

YEARS( [ DatumZeit-Ausdruck, ] DatumZeit-Ausdruck )

Syntax 2

YEARS( DatumZeit-Ausdruck, Ganzzahlausdruck )

Parameter

Rückgabe

Syntax 1 gibt eine Ganzzahl zurück. Syntax 2 gibt einen Zeitstempel zurück.

Bemerkungen

Der Wert von YEARS wird anhand der Anzahl von Neujahrstagen zwischen zwei Datumsangaben berechnet.

Standards und Kompatibilität

Beispiel

Die nachstehenden Anweisungen geben beide -4 zurück.

SELECT YEARS( '1998-07-13 06:07:12',
              '1994-03-13 08:07:13' );

SELECT DATEDIFF( year,
   '1998-07-13 06:07:12',
   '1994-03-13 08:07:13' );

Die folgenden Anweisungen geben "1998" zurück:

SELECT YEARS( '1998-07-13 06:07:12' )
SELECT DATEPART( year, '1998-07-13 06:07:12' );

Die folgenden Anweisungen geben das eingegebene Datum plus 300 Jahre zurück:

SELECT YEARS( CAST( '1998-07-13 06:07:12' AS TIMESTAMP ), 300 )

SELECT DATEADD( year, 300, '1998-07-13 06:07:12' );