次の方法で共有


DATEPART (SSIS)

ある日付の、特定の日付要素を整数で返します。

構文

 DATEPART(datepart, date)

引数

  • datepart
    新しい値を返す日付の要素を指定するパラメータです。

  • date
    有効な日付または日付形式の文字列を返す式です。

戻り値の型

DT_I4

説明

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

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

注意注意

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

次の表に、式エバリュエータで認識される日付要素 (datepart) と省略形を示します。日付要素の名前では大文字と小文字が区別されません。

日付要素

省略形

Year

yy, yyyy

Quarter

qq, q

Month

mm, m

Dayofyear

dy, y

Day

dd, d

Week

wk, ww

Weekday

dw, w

Hour

Hh

Minute

mi, n

Second

ss, s

Millisecond

Ms

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

DATEPART("month", (DT_DBTIMESTAMP)"11/04/2002")

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

DATEPART("dd", ModifiedDate)

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

DATEPART("yy",GETDATE())

関連項目

参照

その他の技術情報