XQuery リファレンス

XQuery 日付および時刻演算子リファレンス

この章では、WebLogic Workshop のマッパー機能で使用できる XQuery 日付および時刻演算子について説明します。マッパー機能を使用してクエリを生成し、クエリを編集して、提供されている XQuery 演算子への呼び出しを追加します。詳細については、クエリ内での関数または演算子の呼び出しを参照してください。

マッパー機能で使用できる XQuery 関数および演算子以外にも、数多くの追加の関数および演算子が用意されています。マッパー機能のソース ビューを使用すると、これらの関数および演算子の呼び出しを手動でクエリに追加できます。追加の関数と演算子のリストについては、次の URL にある W3C Web サイトで、XQuery 1.0 and XPath 2.0 Functions and Operators - W3C Working Draft 16 August 2002 を参照してください。

http://www.w3.org/TR/2002/WD-xquery-operators-20020816

この節では、マッパー機能で使用できる日付および時刻演算子のリストを示します。

op: subtract-dates

$date-var1 と $date-var2. の時間差を計算します。$date-var1 の値から $date-var2 の値を減算します。

$date-var2 の値が $date-var1 の値よりも未来を表す場合は、戻り値は負の期間になります。

$date-var1 または $date-var2 の値が空のシーケンスである場合は、次のエラーが表示されます。

XQuery を実行中にエラーが発生しました : このメソッドに XQuery または XSLT をロードしている際にエラーが発生しました。

Type error in function subtract-dates invocation: expected type

[date@http://www.w3.org/2001/XMLSchema],

given type empty

シグネチャ

op:subtract-dates(xs: date $date-var1, xs: date $date-var2) —>xf: dayTimeDuration

戻り値

$date-var1 と$date-var2 の時間差を dayTimeDuration 値として返します。

例

差が正になる場合

次のクエリ例では、$date-var2 が $date-var1 よりも過去を表すため、正の日数が返されます。

<num_days>{xf:get-days-from-dayTimeDuration(op:subtract-dates(xs:date("2002-08-30"),

xs:date("2001-08-30")))}</num_days>

上のクエリからは、次の結果が生成されます。

<num_days>365</num_days>

差が負になる場合

次のクエリ例では、$date-var2 が $date-var1 よりも未来を表すため、負の日数が返されます。

<num_days>{xf:get-days-from-dayTimeDuration(op:subtract-dates(xs:date("2001-08-30"),

xs:date("2002-08-30")))}</num_days>

上のクエリからは、次の結果が生成されます。

<num_days>-365</num_days>

関連トピック

W3C の subtract-dates 演算子の説明。

W3C の date データ型の説明。

W3C の dayTimeDuration 演算子の説明。

op: subtract-times

$time-var1 と $time-var2 の時間差を計算します。$time-var1 の値から $time-var2 の値を減算します。

$time-var2 の値が $time-var1 の値よりも未来を表す場合は、戻り値は負の期間になります。

$date-var1 または $date-var2 の値が空のシーケンスである場合は、次のエラーが表示されます。

XQuery を実行中にエラーが発生しました : このメソッドに XQuery または XSLT をロードしている際にエラーが発生しました。

Type error in function subtract-dates invocation: expected type [date@http://www.w3.org/2001/XMLSchema],

given type empty

シグネチャ

op:subtract-times(xs: time $time-var1, xs:time $time-var2) —>xs: dayTimeDuration

戻り値

$time-var1 と $time-var2 の時間差を dayTimeDuration 値として返します。

例

差が正になる場合

次のクエリ例では、$time-var2 が $time-var1 よりも過去を表すため、正の分数 (ふんすう) が返されます。

<minutes>{xf:get-minutes-from-dayTimeDuration(op:subtract-times(xf:time("08:01:00"),

xf:time("08:00:00")))}</minutes>

上のクエリからは、次の結果が生成されます。

<minutes>1</minutes>

差が負になる場合

次の例では、$time-var2 が $time-var1 より未来を表すため、負の日数が返されます。

<minutes>{xf:get-minutes-from-dayTimeDuration(op:subtract-times(xf:time("08:00:00"),

xf:time("08:01:00")))}</minutes>

上のクエリからは、次の結果が生成されます。

<minutes>-1</minutes>

関連トピック

W3C の subtract-times 演算子の説明。

W3C の date データ型の説明。

W3C の dayTimeDuration 演算子の説明。

op: add-yearMonthDuration-to-dateTime

$dateTime-var で指定された日付および時刻に $yearMonthDuration-var を加算します。

シグネチャ

op:add-yearMonthDuration-to-dateTime(xs: dateTime $dateTime-var, xf: yearMonthDuration $yearMonthDuration-var) —>xs: date Time

戻り値

$dateTime-var で指定された日付および時刻に $yearMonthDuration-var で指定された年と月を加算したことによる dateTime の結果を返します。返される dateTime 値のタイムゾーンは、$dateTime-var のタイムゾーンと同じです。$dateTime-var にタイムゾーンがない場合は、返される dateTime 値にもタイムゾーンはありません。

例

単純な例

次のクエリ例では、2003 年 1 月 1 日という日付および 1:00 AM という時刻に等しい dateTime 値に 1 年と 1 か月に等しい yearMonthDuration 値を加算しています。

<dateTime>{

op:add-yearMonthDuration-to-dateTime(xs:dateTime("2003-01-01T01:00:00"), xf:yearMonthDuration("P1Y1M"))

}</dateTime>

この場合、次の結果に示すように、2004 年 2 月 1 日という日付と 1:00 AM という時刻に等しい dateTime 値が返されます。

<dateTime>2004-02-01T01:00:00</dateTime>

関連トピック

W3C の add-yearMonthDuration-to-dateTime 演算子の説明。

W3C の yearMonthDuration の説明。

xf: yearMonthDuration コンストラクタの説明

W3C の dateTime データ型の説明。

xf: dateTime コンストラクタの説明。

op: add-dayTimeDuration-to-dateTime

$dateTime-var で指定された日付および時刻に $dayTimeDuration-var を加算します。

シグネチャ

op:add-dayTimeDuration-to-dateTime(xs: dateTime $dateTime-var, xf: dayTimeDuration $dayTimeDuration-var) —> xs:date Time

戻り値

$dateTime-var で指定された日付と時刻に $dayTimeDuration-var で指定された日数と時間を加算したことによる dateTime の結果を返します。返される dateTime 値のタイムゾーンは、$dateTime-var のタイムゾーンと同じです。$dateTime-var にタイムゾーンがない場合は、返される dateTime 値にもタイムゾーンはありません。

例

単純な例

次のクエリ例では、2003 年 1 月 1 日という日付と 1:00 AM という時刻に等しい dateTime 値に 1 日と 2 時間 30 分 5 秒に等しい dayTimeDuration 値を加算しています。

<dateTime>{

op:add-dayTimeDuration-to-dateTime(xs:dateTime("2003-01-01T01:00:00"), xf:dayTimeDuration("P1DT2H30M5S"))

}</dateTime>

この場合、次の結果に示すように、2003 年 1 月 2 日という日付と 3:30:05 AM という時刻に等しい dateTime 値が返されます。

<dateTime>2003-01-02T03:30:05</dateTime>

関連トピック

W3C の add-dayTimeDuration-to-dateTime 演算子の説明。

W3C の dayTimeDuration の説明。

xf: dayTimeDuration コンストラクタの説明

W3C の dateTime データ型の説明。

xs: dateTime コンストラクタの説明

op: subtract-yearMonthDuration-from-dateTime

$dateTime-var で指定された日付および時刻から $yearMonthDuration-var で指定された期間を減算します。

シグネチャ

op:subtract-yearMonthDuration-from-dateTime(xs: dateTime $dateTime-var, xf: yearMonthDuration $yearMonthDuration-var) —>xs:date Time

戻り値

$dateTime-var で指定された日付および時刻から $yearMonthDuration-var で指定された期間を減算したことによる dateTime 値を返します 。

例

正の yearMonthDuration を減算する場合

次のクエリ例では、2003 年 2 月 2 日という日付および 1:01 AM という時刻に等しい dateTime 値から 1 年と 1 か月に等しい正の yearMonthDuration 値を減算しています。

<positive>{

op:subtract-yearMonthDuration-from-dateTime(xs:dateTime("2003-02-02T01:01:00"), xf:yearMonthDuration("P1Y1M"))

}</positive>

この場合、次の結果に示すように、2002 年 1 月 2 日という日付と 1:01 AM という時刻に等しい dateTime 値が返されます。

<positive>2002-01-02T01:01:00</positive>

負の yearMonthDuration を減算する場合

次のクエリ例では、2003 年 1 月 2 日という日付および 1:01 AM という時刻に等しい dateTime 値から 1 年と 1 か月に等しい負の yearMonthDuration 値を減算しています。

<negative>{

op:subtract-yearMonthDuration-from-dateTime(xs:dateTime("2003-01-02T01:01:00"), xf:yearMonthDuration("-P1Y1M"))

}</negative>

この場合、次の結果に示すように、2004 年 2 月 2 日という日付と 1:01 AM という時刻に等しい dateTime 値が返されます。

<negative>2004-02-02T01:01:00</negative>

関連トピック

W3C の subtract-yearMonthDuration-from-dateTime 演算子の説明。

W3C の yearMonthDuration の説明。

xf: yearMonthDuration コンストラクタの説明

W3C の dateTime データ型の説明。

xs: dateTime コンストラクタの説明

op: subtract-dayTimeDuration-from-dateTime

$dateTime-var で指定された日付および時刻から $dayTimeDuration-var で指定された期間を減算します。

シグネチャ

op:subtract-dayTimeDuration-from-dateTime(xs: dateTime $dateTime-var, xf: dayTimeDuration $ dayTimeDuration-var) —> xs:date Time

戻り値

$dateTime-var で指定された日付および時刻から $dayTimeDuration-var で指定された期間を減算したことによる dateTime 値を返します 。

例

正の dayTimeDuration を減算する場合

次のクエリ例では、2003 年 1 月 2 日という日付と 1:01 AM という時刻に等しい dateTime 値から 1 日と 1 分に等しい正の dayTimeDuration 値を減算しています。

<positive>{

op:subtract-dayTimeDuration-from-dateTime(xs:dateTime("2003-01-02T01:01:00"), xf:dayTimeDuration("P1DT1M"))

}</positive>

この場合、次の結果に示すように、2003 年 1 月 1 日という日付と 1:00 AM という時刻に等しい dateTime 値が返されます。

<positive>2003-01-01T01:00:00</positive>

負の dayTimeDuration を減算する場合

次のクエリ例では、2003 年 1 月 2 日という日付と 1:01 AM という時刻に等しい dateTime 値から 1 日と 1 分に等しい負の dayTimeDuration 値を減算しています。

<negative>{

op:subtract-dayTimeDuration-from-dateTime(xs:dateTime("2003-01-02T01:01:00"), xf:dayTimeDuration("-P1DT1M"))

}</negative>

この場合、次の結果に示すように、2003 年 1 月 3 日という日付と 1:02 AM という時刻に等しい dateTime 値が返されます。

<negative>2003-01-03T01:02:00</negative>

関連トピック

W3C の subtract-dayTimeDuration-from-dateTime 演算子の説明。

W3C の dayTimeDuration の説明。

xf: dayTimeDuration コンストラクタの説明

W3C の dateTime データ型の説明。

xs: dateTime コンストラクタの説明

op: add-yearMonthDuration-to-date

$date-var で指定された日付に $yearMonthDuration-var を加算します。

シグネチャ

op:add-yearMonthDuration-to-date(xs: date $date-var, xf: yearMonthDuration $yearMonthDuration-var) —> xs:date

戻り値

$date-var で指定された日付に $yearMonthDuration-var で指定された年と月を加算したことによる date の結果を返します。返される date 値のタイムゾーンは、$date-var のタイムゾーンと同じです。$date-var にタイムゾーンがない場合は、返される date 値にもタイムゾーンはありません 。

例

単純な例

次のクエリ例では、2003 年 1 月 1 日という日付に等しい date 値に 1 年 1 か月に等しい yearMonthDuration 値を加算しています。

<date>{

op:add-yearMonthDuration-to-date(xs:date("2003-01-01"), xf:yearMonthDuration("P1Y1M"))

}</date>

この場合、次の結果に示すように、2004 年 2 月 1 日という日付に等しい date 値が返されます。

<date>2004-02-01</date>

関連トピック

W3C の add-yearMonthDuration-to-date 演算子の説明。

W3C の yearMonthDuration の説明。

xf: yearMonthDuration コンストラクタの説明

W3C の date データ型の説明。

xs: date コンストラクタの説明

op: add-dayTimeDuration-to-date

$date-var で指定された日付に $dayTimeDuration-var を加算します。

シグネチャ

op:add-dayTimeDuration-to-date(xs: date $date-var, xf: dayTimeDuration $dayTimeDuration-var) —>xs:date

戻り値

$date-var で指定された日付に $dayTimeDuration-var で指定された日付と時刻を加算したことによる date の結果を返します。返される date 値のタイムゾーンは、$date-var のタイムゾーンと同じです。$date-var にタイムゾーンがない場合は、返される date 値にもタイムゾーンはありません。

例

単純な例

次のクエリ例では、2003 年 1 月 1 日に等しい date 値に 1 日と 2 時間 30 分 5 秒に等しい dayTimeDuration 値を加算しています。

<date>{

op:add-dayTimeDuration-to-date(xs:date("2003-01-01"), xf:dayTimeDuration("P1DT2H30M5S"))

}</date>

この場合、次の結果に示すように、2003 年 1 月 2 日にという日付に等しい date 値が返されます。

<date>2003-01-02</date>

関連トピック

W3C の add-dayTimeDuration-to-date 演算子の説明。

W3C の dayTimeDuration の説明。

xf: dayTimeDuration コンストラクタの説明

W3C の date データ型の説明。

xs: date コンストラクタの説明

op: subtract-yearMonthDuration-from-date

$date-var で指定された日付から $yearMonthDuration-var で指定された期間を減算します。

シグネチャ

op:subtract-yearMonthDuration-from-date(xs: date $date-var, xf: yearMonthDuration $yearMonthDuration-var) —> xs:date

戻り値

$date-var で指定された日付から $yearMonthDuration-var で指定された期間を減算したことによる date 値を返します。

例

正の yearMonthDuration を減算する場合

次のクエリ例では、2003 年 2 月 2 日という日付に等しい date 値から 1 年と 1 か月に等しい正の yearMonthDuration 値を減算しています。

<positive>{

op:subtract-yearMonthDuration-from-date(xs:date("2003-02-02"), xf:yearMonthDuration("P1Y1M"))

}</positive>

この場合、次の結果に示すように、2002 年 1 月 2 日に等しい date 値が返されます。

<positive>2002-01-02</positive>

負の yearMonthDuration を減算する場合

次のクエリ例では、2003 年 1 月 2 日という日付に等しい date 値から 1 年と 1 か月に等しい負の yearMonthDuration 値を減算しています。

<negative>{

op:subtract-yearMonthDuration-from-date(xs:date("2003-01-02"), xf:yearMonthDuration("-P1Y1M"))

}</negative>

この場合、次の結果に示すように、2004 年 2 月 2 日という日付に等しい date 値が返されます。

<negative>2004-02-02</negative>

関連トピック

W3C の subtract-yearMonthDuration-from-date 演算子の説明。

W3C の yearMonthDuration の説明。

xf: yearMonthDuration コンストラクタの説明

W3C の date データ型の説明。

xs: date コンストラクタの説明

op: subtract-dayTimeDuration-from-date

$date-var で指定された日付から $dayTimeDuration-var で指定された期間を減算します。

シグネチャ

op:subtract-dayTimeDuration-from-date(xs: date $date-var, xf: dayTimeDuration $dayTimeDuration-var) —>xs:date

戻り値

$date-var で指定された日付から $dayTimeDuration-var で指定された期間を減算したことによる date 値を返します。

例

正の dayTimeDuration を減算する場合

次のクエリ例では、2003 年 1 月 2 日という日付に等しい date 値から 1 日と 1 分に等しい正の dayTimeDuration 値を減算しています。

<positive>{

op:subtract-dayTimeDuration-from-date(xs:date("2003-01-02"), xf:dayTimeDuration("P1DT1M"))

}</positive>

この場合、次の結果に示すように、2003 年 1 月 1 日という日付に等しい date 値が返されます。

<positive>2003-01-01</positive>

負の dayTimeDuration を減算する場合

次のクエリ例では、2003 年 1 月 2 日という日付に等しい date 値から 1 日と 1 分に等しい負の dayTimeDuration 値を減算しています。

<negative>{

op:subtract-dayTimeDuration-from-date(xs:date("2003-01-02"), xf:dayTimeDuration("-P1DT1M"))

}</negative>

この場合、次の結果に示すように、2003 年 1 月 3 日という日付に等しい date 値が返されます。

<negative>2003-01-03</negative>

関連トピック

W3C の subtract-dayTimeDuration-from-date 演算子の説明。

W3C の dayTimeDuration の説明。

xf: dayTimeDuration コンストラクタの説明

W3C の date データ型の説明。

xs: date コンストラクタの説明

op: add-dayTimeDuration-to-time

$time-var で指定された時刻に $dayTimeDuration-var を加算します。

シグネチャ

op:add-dayTimeDuration-to-time(xs: time $time-var, xf: dayTimeDuration $dayTimeDuration-var) —>xs: time

戻り値

$time-var で指定された時刻に $dayTimeDuration-var で指定された日付と時刻を加算したことによる time の結果を返します。返される time 値のタイムゾーンは、$time-var のタイムゾーンと同じです。$time-var にタイムゾーンがない場合は、返される time 値にもタイムゾーンはありません。

例

単純な例

次のクエリ例では、1:00 AM という時刻に等しい time 値に 1 日と 2 時間 30 分 5 秒に等しい dayTimeDuration 値を加算しています 。

<time>{

op:add-dayTimeDuration-to-time(xs:time("01:00:00"), xf:dayTimeDuration("P1DT2H30M5S"))

}</time>

この場合、次の結果に示すように、3:30:05 AM という時刻に等しい time 値が返されます。

<time>03:30:05</time>

関連トピック

W3C の add-dayTimeDuration-to-time 演算子の説明。

W3C の dayTimeDuration の説明。

xf: dayTimeDuration コンストラクタの説明

W3C の time データ型の説明。

xs:time コンストラクタの説明

op: subtract-dayTimeDuration-from-time

$time-var で指定された時刻から $dayTimeDuration-var で指定された期間を減算します。

シグネチャ

op:subtract-dayTimeDuration-from-time(xs: time $time-var, xf: dayTimeDuration $dayTimeDuration-var) —>xs: time

戻り値

$time-var で指定された日付および時刻から $dayTimeDuration-var で指定された期間を減算したことによる time 値を返します。

例

正の dayTimeDuration を減算する場合

次のクエリ例では、1:01 AM という時刻に等しい time 値から 1 日と 1 分に等しい dayTimeDuration 値を減算しています。

<positive>{

op:subtract-dayTimeDuration-from-time(xs:time("01:01:00"), xf:dayTimeDuration("P1DT1M"))

}</positive>

この場合、次の結果に示すように、1:00 AM という時刻に等しい time 値が返されます。

<positive>01:00:00</positive>

負の dayTimeDuration を減算する場合

次のクエリ例では、1:01 AM という時刻に等しい time 値から 1 日と 1 分に等しい負の dayTimeDuration 値を減算しています。

<negative>{

op:subtract-dayTimeDuration-from-time(xs:time("01:01:00"), xf:dayTimeDuration("-P1DT1M"))

}</negative>

この場合、次の結果に示すように、1:02 AM という時刻に等しい time 値が返されます。

<negative>01:02:00</negative>

関連トピック

W3C の subtract-dayTimeDuration-from-time 演算子の説明。

W3C の dayTimeDuration の説明。

xf: dayTimeDuration コンストラクタの説明

W3C の time データ型の説明。

xs:time コンストラクタの説明