YEARS-Funktion [Datum und Uhrzeit]

Die YEARS-Funktion bearbeitet einen TIMESTAMP-Wert oder liefert die Anzahl von Jahren zwischen zwei TIMESTAMP-Werten. Weitere Hinweise finden Sie im folgenden Abschnitt "Bemerkungen".

Syntax 1

YEARS( timestamp-expression )

Syntax 2

YEARS( timestamp-expression, timestamp-expression )

Syntax 2

YEARS( timestamp-expression, integer-expression )

Parameter

timestamp-expression Ein Datums- und Uhrzeitwert vom Typ TIMESTAMP.
integer-expression Die Anzahl der Jahre (als SMALLINT Wert), die zu timestamp-expression zu addieren ist. Wenn integer-expression negativ ist, wird die entsprechende Anzahl an Jahren von timestamp-expression. Wenn Sie eine integer-expression angeben, muss timestamp-expression explizit als TIME-, DATE- oder TIMESTAMP-Wert festgelegt sein. Wenn timestamp-expression ein TIME-Wert ist, wird das aktuelle Jahr angenommen.
Hinweise zur Konvertierung von Datentypen finden Sie unter CAST-Funktion [Datentypkonvertierung].

Rückgabe

Bemerkungen

Siehe auch

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' );

Kommentieren Sie diese Seite in DocCommentXchange.