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 関数で使用できる日付要素と省略形の表を追加しました。