DATEPART (SSIS)

更新 : 2005 年 12 月 5 日

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

構文

DATEPART(datepart, date)

引数

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

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

戻り値の型

DT_I4

解説

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

日付リテラルは、日付データ型のいずれかに明示的にキャストされる必要があります。

次の表に、式エバリュエータで認識される日付要素 (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())

参照

関連項目

DATEADD (SSIS)
DATEDIFF (SSIS)
DAY (SSIS)
MONTH (SSIS)
YEAR (SSIS)

その他の技術情報

関数 (SSIS)

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴

リリース	履歴
2005 年 12 月 5 日	新しい内容 : DATEPART 関数で使用できる日付要素と省略形の表を追加しました。