YEAR (SSIS 式)

ある日付の、年の日付要素を表す整数値を返します。

構文

YEAR(date)

引数

  • date
    任意の日付形式の日付です。

戻り値の型

DT_I4

説明

引数が NULL の場合、YEAR は NULL を返します。

日付リテラルは、日付データ型のいずれかに明示的にキャストされる必要があります。詳細については、「Integration Services のデータ型」を参照してください。

注意

日付リテラルが DT_DBTIMESTAMPOFFSET と DT_DBTIMESTAMP2 のいずれかの日付データ型に明示的にキャストされると、式の検証は失敗します。

YEAR 関数を使用すると、DATEPART("Year", date) 関数を使用する場合と同じ結果を、より簡単に取得できます。

この例では、日付リテラルの年を表す数値が返されます。データが mm/dd/yyyy 形式の場合、この例では "2002" が返されます。

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

この例では、ModifiedDate 列内の年を表す整数が返されます。

YEAR(ModifiedDate)

この例では、現在の日付の年を表す整数が返されます。

YEAR(GETDATE())