YEARS 関数 [日付と時刻]

YEARS 関数は、TIMESTAMP を操作するか、2 つの TIMESTAMP 値の間の年数を返します。次の「備考」の項を参照してください。

YEARS( timestamp-expression )

YEARS( timestamp-expression, timestamp-expression )

YEARS( timestamp-expression, integer-expression )

timestamp-expression TIMESTAMP データ型の値の日付と時刻。
integer-expression timestamp-expression に (SMALLINT 値として) 追加される年数。integer-expression が負の場合、timestamp-expression. から適切な年数が引かれます。integer-expression を指定する場合は、timestamp-expression を DATE、TIME、または TIMESTAMP 値として明示的にキャストしてください。timestamp-expression が TIME 値の場合、現在の年が使用されます。
データ型のキャストの詳細については、CAST 関数 [データ型変換]を参照してください。

次の文はどちらも -4 を返します。

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

次の文は、1998 を返します。

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

次の文は、指定した日付の 300 年後を返します。

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

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