YEAR (SSIS 式)

適用対象: SQL Server Azure Data Factory の SSIS 統合ランタイム

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

構文

  
YEAR(date)

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

DT_I4

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

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

Note

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

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

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

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

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

YEAR(ModifiedDate)

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

YEAR(GETDATE())