DATEPART (SSIS 式)

適用対象:SQL Server Azure Data Factory の SSIS Integration Runtime

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

構文

  
DATEPART(datepart, date)  

引数

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

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

戻り値の型

DT_I4

注釈

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

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

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

datepart	省略形
Year	yy、yyyy
Quarter	qq、q
Month	mm、m
Dayofyear	dy、y
日間	dd、d
週	wk、ww
平日	dw
時間	Hh、hh、HH
分	mi、n
Second	ss、s
Millisecond	Ms

SSIS 式の例

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

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

この例は、 ModifiedDate 列内の日を表す整数を返します。

DATEPART("dd", ModifiedDate)  

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

DATEPART("yy",GETDATE())  

これらの例では、すべて 19 が返されます。

DATEPART("HH", (DT_DATE) "2020-09-02 19:24" )
DATEPART("hh", (DT_DATE) "2020-09-02 19:24" )
DATEPART("Hh", (DT_DATE) "2020-09-02 19:24" )

関連項目

DATEADD (SSIS 式)
DATEDIFF (SSIS 式)
DAY (SSIS 式)
MONTH (SSIS 式)
YEAR (SSIS 式)
関数 (SSIS 式)