タスクフロー

前へ次へ

getDatePart

日付の中の指定した部分を整数値として返します。そのため、日付の月の部分を返す式を作成して「Apr 1 1997 00:00:00」のような日付を渡すと、getDatePartは4を返します。

構文

date:getDatePart(xs:dateTime('date'), 'format')

xs:dateTime句を手動で追加し、日付値を一重引用符で囲む必要があります。

次の表に、引数を示します。

引数	必須/オプション	説明
date	必須	Date/Timeデータ型。有効なトランスフォーメーション式を必要に応じて入力できます。
format	必須	日付値の中で返す部分を指定するフォーマット文字列。フォーマット文字列は'mm'のように一重引用符で囲みます。フｫーマット文字列は大文字と小文字を区別しません。例えば、日付「Apr 1 1997」をgetDatePartに渡す場合、フォーマット文字列'Y'、'YY'、'YYY'、'YYYY'はすべて1997を返します。

戻り値

日付の中の指定された部分を示す整数。

関数にNULL値を渡した場合はNULLです。

例

以下の式は、DATE_SHIPPEDカラムの各日付の時の部分を返します。デフｫルトの日付形式は24時間方式に基づくため、12:00:00AMは0を返します。

date:getDatePart(xs:dateTime('DATE_SHIPPED'), 'HH')
date:getDatePart(xs:dateTime('DATE_SHIPPED'), 'HH12')
date:getDatePart(xs:dateTime('DATE_SHIPPED'), 'HH24')

次の表に、一部のサンプル値と戻り値を示します。

DATE_SHIPPED	RETURN VALUE
Mar 13 1997 12:00:00AM	0
Sep 2 1997 2:00:01AM	2
Aug 22 1997 12:00:00PM	12
June 3 1997 11:30:44PM	23
NULL	NULL

以下の式は、DATE_SHIPPEDカラムの各日付の日の部分を返します。

date:getDatePart(xs:dateTime('DATE_SHIPPED'), 'D')
date:getDatePart(xs:dateTime('DATE_SHIPPED'), 'DD')
date:getDatePart(xs:dateTime('DATE_SHIPPED'), 'DDD')
date:getDatePart(xs:dateTime('DATE_SHIPPED'), 'DY')
date:getDatePart(xs:dateTime('DATE_SHIPPED'), 'DAY')

次の表に、一部のサンプル値と戻り値を示します。

DATE_SHIPPED	RETURN VALUE
Mar 13 1997 12:00:00AM	13
June 3 1997 11:30:44PM	3
Aug 22 1997 12:00:00PM	22
NULL	NULL

以下の式は、DATE_SHIPPEDカラムの各日付の月の部分を返します。

date:getDatePart(xs:dateTime('DATE_SHIPPED'), 'MM')
date:getDatePart(xs:dateTime('DATE_SHIPPED'), 'MON')
date:getDatePart(xs:dateTime('DATE_SHIPPED'), 'MONTH')

次の表に、一部のサンプル値と戻り値を示します。

DATE_SHIPPED	RETURN VALUE
Mar 13 1997 12:00:00AM	3
June 3 1997 11:30:44PM	6
NULL	NULL

以下の式は、DATE_SHIPPEDカラムの各日付の年の部分を返します。

date:getDatePart(xs:dateTime('DATE_SHIPPED'), 'Y')
date:getDatePart(xs:dateTime('DATE_SHIPPED'), 'YY')
date:getDatePart(xs:dateTime('DATE_SHIPPED'), 'YYY')
date:getDatePart(xs:dateTime('DATE_SHIPPED'), 'YYYY')

次の表に、一部のサンプル値と戻り値を示します。