DATEPART (SSIS)
ある日付の、特定の日付要素を整数で返します。
構文
DATEPART(datepart, date)
引数
datepart
新しい値を返す日付の要素を指定するパラメータです。date
有効な日付または日付形式の文字列を返す式です。
戻り値の型
DT_I4
説明
引数が NULL の場合、DATEPART は NULL を返します。
日付リテラルは、日付データ型のいずれかに明示的にキャストされる必要があります。詳細については、「Integration Services のデータ型」を参照してください。
.gif "注意") 注意 |
|---|
日付リテラルが 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())