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( Zeitstempelausdruck )

Syntax 2

YEARS( Zeitstempelausdruck, Zeitstempelausdruck )

Syntax 2

YEARS( Zeitstempelausdruck, Ganzzahlausdruck )

Parameter

Zeitstempelausdruck Ein Datums- und Uhrzeitwert vom Typ TIMESTAMP.
Ganzzahlausdruck Die Anzahl der Jahre (als SMALLINT Wert), die zu Zeitstempelausdruck. zu addieren ist. Wenn Ganzzahlausdruck negativ ist, wird die entsprechende Anzahl an Jahren von Zeitstempelausdruck. abgezogen. Wenn Sie einen Ganzzahlausdruck angeben, muss Zeitstempelausdruck explizit als TIME-, DATE- oder TIMESTAMP-Wert festgelegt sein. Wenn Zeitstempelausdruck 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.