![]() ![]() ![]() ![]() |
この章では、WebLogic Workshop のマッパー機能で使用できる XQuery 型変換関数について説明します。マッパー機能を使用してクエリを生成し、クエリを編集して、提供されている XQuery 関数への呼び出しを追加します。詳細については、クエリ内での関数と演算子の呼び出しを参照してください。
WebLogic Workshop のマッパー機能で使用できる 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
この節では、マッパー機能で使用できる型変換関数のリストを示します。
$item-var
の値を文字列 (string) に変換します。
$item-var
が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()」であり、SQL の null のようなものです。
xs:string
(item* $item-var
) —>xs:
string
let $i := <book>The Toad</book>
return <author>{xs:string($i)}</author>
return (<integer>{xs:string($num)}</integer>)
return (<float>{xs:string($num)}</float>)
let $boolean-var := xs:boolean("true")
return (<boolean>{xs:string($boolean-var)}</boolean>)
W3C の string 関数の説明。
$string-var
(文字列) を 10 進数 (decimal) 値に変換します。
$string-var
が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()」であり、SQL の null のようなものです。
xs:decimal
(xs:
string $string-var
) —> xs:
decimal
decimal("2.2")
を呼び出すと、次のクエリ例に示すように、10 進数値 2.2 が返されます。
<decimal>{xs:decimal("2.2")}</decimal>
decimal(())
を呼び出すと、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()」であり、SQL の null のようなものです。
<decimal>{xs:decimal(())}</decimal>
W3C の decimal データ型の説明。
$string-var
(文字列) を integer 値に変換します。
$string-var
の値が 9,223,372,036,854,775,807 より大きいか、または -9,223,372,036,854,775,808 より小さい場合は、エラー コード SYS_LONG_OVERFLOW
で TransformException 例外が生成されます。マッパーには次のエラー メッセージが表示されます。
XQuery を実行中にエラーが発生しました : BigDecimal -> Long オーバフロー!
注意 : | パフォーマンス上の理由から、この XQuery エンジンによってサポートされる integer は Java の long に相当します。Java の long は、任意の長さを取る W3C XML スキーマの integer よりも小さくなります。詳細については、「integer」の説明を参照してください。 |
注意 : | $string-var の値は、次の呼び出し例に示すように、カンマを付けずに指定する必要があります。 |
$string-var
の値が空のシーケンスの場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()」であり、SQL の null のようなものです。
xs:integer
(xs:
string $string-var
) —> xs: integer
$string-var
の integer 値が返されます。
integer("10402")
を呼び出すと、次のクエリ例に示すように、整数値 10402 が返されます。
<integer>{xs:integer("10402")}</integer>
integer("104.0")
を呼び出すと、引数では小数点が許可されないため、エラーが出力されます。
<integer>{xs:integer("104.0")}</integer>
XQuery を実行中にエラーが発生しました : "104.0" を型 [integer@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
integer("foo")
を呼び出すと、"foo"
は数字ではないため、エラーが出力されます。
<integer>{xs:decimal("foo")}</integer>
XQuery を実行中にエラーが発生しました : "foo" を型 [integer@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
integer(())
を呼び出すと、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
<integer>{xs:integer(())}</integer>
この XQuery エンジンでの integer の最大値は 9,223,372,036,854,775,807、最小値は 9,223,372,036,854,775,808 です。パフォーマンス上の理由から、この XQuery エンジンによってサポートされる integer は Java の long に相当します。Java の long は、任意の長さを取る W3C XML スキーマの integer よりも小さくなります。
integer データ型の説明
プログラム的に TransformException エラー コードを取得する
$string-var
(文字列) を long 値に変換します。
$string-var
の値が 9,223,372,036,854,775,807 より大きいか、または -9,223,372,036,854,775,808 より小さい場合は、エラー メッセージが表示されます。
XQuery を実行中にエラーが発生しました : "9223372036854775809" を型 [long@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
注意 : | $string-var の値は、次の呼び出し例に示すように、カンマを付けずに指定する必要があります。 |
$string-var
が空のシーケンスである場合は、空のシーケンスが返されます。
空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
xs:long(xs:
string $string-var)
—> xs:
long
long("10403")
を呼び出すと、次のクエリ例に示すように、整数値 10403
が返されます。
<long>{xs:long("10403")}</long>
long("104.0")
を呼び出すと、104.0
は有効な整数ではない (小数点は許可されない) ため、エラーが出力されます。
<long>{xs:long("104.0")}</long>
XQuery を実行中にエラーが発生しました : "104.0" を型 [long@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
long("foo")
を呼び出すと、"foo"
は数字ではないため、エラーが出力されます。
XQuery を実行中にエラーが発生しました : "foo" を型 [long@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
long(())
を呼び出すと、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
W3C の long データ型の説明。
$string-var
(文字列) を int 値に変換します。
$string-var
の値が 2,147,483,647 より大きいか、または -2,147,483,648 より小さい場合は、次のエラーが発生します。
XQuery を実行中にエラーが発生しました : "2147483649" を型 [int@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
注意 : | $string-var の値は、次の呼び出し例に示すように、カンマを付けずに指定する必要があります。 |
$string-var
の値が空のシーケンスの場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
xs:int(xs:
string $string-var) —>xs: int
int("10403")
を呼び出すと、次のクエリ例に示すように、整数値 10403
が返されます。
int("104.0")
を呼び出すと、104.0
は有効な整数ではない (小数点は許可されない) ため、エラーが出力されます。
XQuery を実行中にエラーが発生しました : "104.0" を型 [int@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
int("foo")
を呼び出すと、"foo"
は数字ではないため、エラーが出力されます。
XQuery を実行中にエラーが発生しました : "foo" を型 [int@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
int(())
を呼び出すと、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
W3C の int データ型の説明。
$string-var
(文字列) を short 値に変換します。
$string-var
の値が 32,767 より大きいか、または -32,768 より小さい場合は、次のエラーが発生します。
XQuery を実行中にエラーが発生しました : "32769" を型 [short@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
$string-var の値が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()」であり、SQL の null のようなものです。
xs:short(xs:
string $string-var) —>xs: short
short("10403")
を呼び出すと、次のクエリ例に示すように、整数値 10403
が返されます。
<short>{xs:short("10403")}</short>
short("104.0")
を呼び出すと、104.0
は有効な整数ではない (小数点は許可されない) ため、エラーが出力されます。
<short>{xs:short("104.0")}</short>
XQuery を実行中にエラーが発生しました : "104.0" を型 [short@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
short("foo")
を呼び出すと、"foo"
は数字ではないため、エラーが出力されます。
<short>{xs:short("foo")}</short>
XQuery を実行中にエラーが発生しました : "foo" を型 [short@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
short(())
を呼び出すと、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
W3C の short データ型の説明。
$string-var
(文字列) を byte 値に変換します。
$string-var
の値が 127 より大きいか、または -128 より小さい場合は、次のエラーが発生します。
XQuery を実行中にエラーが発生しました : "129" を型 [byte@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
$string-var
の値が空のシーケンスの場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
xs:byte(xs:
string $string-var) —>xs:
byte
byte("104")
を呼び出すと、次のクエリ例に示すように、整数値 104
が返されます。
byte("104.0")
を呼び出すと、104.0
は有効な整数ではない (小数点は許可されない) ため、エラーが出力されます。
<byte>{xs:byte("104.0")}</byte>
XQuery を実行中にエラーが発生しました : "104.0" を型 [byte@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
byte("foo")
を呼び出すと、"foo"
は数字ではないため、エラーが出力されます。
XQuery を実行中にエラーが発生しました : "foo" を型 [byte@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
byte(())
を呼び出すと、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
W3C の byte データ型の説明。
$string-var
(文字列) を 32 ビット浮動小数点 (float) 値に変換します。float データ型は、IEEE の単精度浮動小数点型 (IEEE Std 754-1985) に対応しています。
$string-var
の値が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
xs:float(xs:
string $string-var) —>xs:
float
float("1.1")
を呼び出すと、次のクエリ例に示すように、浮動小数点値 1.1
が返されます。
<float>{xs:float("1.1")}</float>
float("-104.345e2")
を呼び出すと、次のクエリ例に示すように、浮動小数点値 -10434.5
が返されます。
<float>{xs:float("-104.345e2")}</float>
文字列 NaN
(Not a Number) は、次のクエリ例に示すように、有効な引数です。
<float>{xs:float("NaN")}</float>
文字列 INF
(正の無限大) と -INF
(負の無限大) は、次のクエリ例に示すように、有効な引数です。
<positive>{xs:float("INF")}</positive>
<negative>{xs:float("-INF")}</negative>
<negative>-Infinity</negative>
float("10.1e2.1")
を呼び出すと、2.1
が整数ではないため、エラーが出力されます。たとえば、次のクエリ例の場合、
<float>{xs:float("10.1e2.1")}</float>
XQuery を実行中にエラーが発生しました : "10.1e2.1" を型 [float@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
float(())
を呼び出すと、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
W3C の float データ型の説明。
$string-var
(文字列) を倍精度 (64 ビット) 浮動小数点 (double) 値に変換します。
double データ型は、IEEE の倍精度浮動小数点型 (IEEE Std 754-1985) に対応しています。
$string-var
の値が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()」であり、SQL の null のようなものです。
xs:double(xs:
string $string-var) —> xs:
double
double("1.1")
を呼び出すと、次のクエリ例に示すように、倍精度小数点値 1.1
が返されます。
<double>{xs:double("1.1")}</double>
double("-104.345e2")
を呼び出すと、次のクエリ例に示すように、倍精度浮動小数点値 -10434.5
が返されます。
<double>{xs:double("-104.345e2")}</double>
文字列 NaN
(Not a Number) は、次のクエリ例に示すように、有効な引数です。
<double>{xs:double("NaN")}</double>
文字列 INF
(正の無限大) と -INF
(負の無限大) は、次のクエリ例に示すように、有効な引数です。
<positive>{xs:double("INF")}</positive>
<negative>{xs:double("-INF")}</negative>
<negative>-Infinity</negative>
double("10.1e2.1")
を呼び出すと、2.1
が整数ではないため、エラーが出力されます。たとえば、次のクエリ例の場合、
<double>{xs:double("10.1e2.1")}</double>
XQuery を実行中にエラーが発生しました : "10.1e2.1" を型 [double@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
double(())
を呼び出すと、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
<double>{xs:double(())}</double>
W3C の double データ型の説明。
$node-var
(XML 要素) の値を倍精度浮動小数点 (double) 値に変換します。
xf:
number(xf
: node $node-var) —> xs:
double
let $numnode := <a><b>12.1</b></a>
return (<num>{xf:number($numnode/b)}</num>
)
W3C の number 関数の説明。
XML ノードのシーケンスを、整数のシーケンスに変換します。この関数は通常、xf: max 関数および xf: min 関数と共に使用されます。
bea-xf:
: integer-sequence(
node*$node-var)
—> xs:integer*
次のクエリを呼び出すと、次のクエリ例に示すように、整数のシーケンスが返されます。
return <result>{bea-xf:integer-sequence(($x,$y,$z))}</result>
$string-var
(文字列) をブール値に変換します。
xs:
boolean(xs:
string $string-var)—> xs:
boolean
xs:boolean("false")
を呼び出すと、次のクエリ例に示すように、ブール値 false
が返されます。
<result>{xs:boolean("false")}</result>
xs:boolean("1")
を呼び出すと、次のクエリ例に示すように、ブール値 true
が返されます。
<result>{xs:boolean("1")}</result>
W3C の boolean 関数の説明。
$string-var
(dateTime フォーマットの文字列) を dateTime データ型に変換します。
$string-var
の値が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
$string-var
の値が有効な dateTime フォーマットでない場合、次のエラーが表示されます。
"invalid_dateTime_string"
を型
[date@htttp://www.w3.org/2001/XMLSchema] にキャストできませんでした。
ここで、invalid_dateTime_string は dateTime フォーマットで有効でない文字列 (たとえば "2003-08-16T21:10"
) です。
xs: dateTime(xs:
string $string-var) —> xs:
dateTime
指定された日付と時刻を dateTime データ型で返します。
dateTime("2003-08-16T21:10:50")
を呼び出すと、次のクエリ例に示すように、現在のタイム ゾーンでの 2003 年 8 月 16 日午後 9 時 10 分 (24 時間制では 21 時 10 分) 50 秒に対応する dateTime 値が返されます。
let $mydate := xs:dateTime("2003-08-16T21:10:50")
<year>{xf:get-year-from-dateTime($mydate)}</year>
<month>{xf:get-month-from-dateTime($mydate)}</month>
<day>{xf:get-day-from-dateTime($mydate)}</day>
<hour>{xf:get-hours-from-dateTime($mydate)}</hour>
<minute>{xf:get-minutes-from-dateTime($mydate)}</minute>
<second>{xf:get-seconds-from-dateTime($mydate)}</second>
dateTime("2003-08-16T21:10:50.577")
を呼び出すと、次のクエリ例に示すように、現在のタイム ゾーンでの 2003 年 8 月 16 日午後 9 時 10 分 (24 時間制では 21 時 10 分) 50.577 秒に対応する dateTime 値が返されます。
let $mydate := xs:dateTime("2003-08-16T21:10:50.557")
<year>{xf:get-year-from-dateTime($mydate)}</year>
<month>{xf:get-month-from-dateTime($mydate)}</month>
<day>{xf:get-day-from-dateTime($mydate)}</day>
<hour>{xf:get-hours-from-dateTime($mydate)}</hour>
<minute>{xf:get-minutes-from-dateTime($mydate)}</minute>
<second>{xf:get-seconds-from-dateTime($mydate)}</second>
dateTime("2003-08-16T21:10:50Z")
を呼び出すと、次のクエリ例に示すように、UTC タイム ゾーンでの 2003 年 8 月 16 日午後 9 時 10 分 (24 時間制では 21 時 10 分) 50 秒に対応する dateTime 値が返されます。
let $mydate := xs:dateTime("2003-08-16T21:10:50Z")
<year>{xf:get-year-from-dateTime($mydate)}</year>
<month>{xf:get-month-from-dateTime($mydate)}</month>
<day>{xf:get-day-from-dateTime($mydate)}</day>
<hour>{xf:get-hours-from-dateTime($mydate)}</hour>
<minute>{xf:get-minutes-from-dateTime($mydate)}</minute>
<second>{xf:get-seconds-from-dateTime($mydate)}</second>
dateTime("2003-08-16T13:10:50-07:00")
を呼び出すと、次のクエリ例に示すように、UTC (協定世界時) から 7 時間遅れている太平洋夏時間 (PDT) タイム ゾーンでの 2003 年 8 月 16 日午後 1 時 10 分 (24 時間制では 13 時 10 分) 50 秒に対応する dateTime 値が返されます。
let $mydate := xs:dateTime("2003-08-16T13:10:50-07:00")
<year>{xf:get-year-from-dateTime($mydate)}</year>
<month>{xf:get-month-from-dateTime($mydate)}</month>
<day>{xf:get-day-from-dateTime($mydate)}</day>
<hour>{xf:get-hours-from-dateTime($mydate)}</hour>
<minute>{xf:get-minutes-from-dateTime($mydate)}</minute>
<second>{xf:get-seconds-from-dateTime($mydate)}</second>
dateTime("2003-08-16T21:10")
を呼び出すと、秒が指定されていないため、エラーが出力されます。
<result>{xs:dateTime("2003-08-16T21:10")}</result>
XQuery を実行中にエラーが発生しました : "2003-08-16T21:10" を型 [dateTime@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
dateTime("2003-8-16T21:10:50")
を呼び出すと、月が 2 桁で指定されていないため、エラーが出力されます。
<result>{xs:dateTime("2003-8-16T21:10:50")}</result>
XQuery を実行中にエラーが発生しました : "2003-8-16T21:10:50" を型 [dateTime@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
W3C の dateTime データ型の説明。
$string-var
(date フォーマットの文字列) を date データ型に変換します。
$string-var
の値が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、 SQL の null のようなものです。
$string-var の値が有効な date フォーマットでない場合、次のエラーが表示されます。
"invalid_date_string"
を型
[date@htttp://www.w3.org/2001/XMLSchema] にキャストできませんでした。
ここで、invalid_date_string は date フォーマットで有効でない文字列 (たとえば "2003-04-31"
) です。
xs:date(xs:
string $string-var)—> xs:
date
date("2003-08-16")
を呼び出すと、次のクエリ例に示すように、現在のタイム ゾーンで 2003 年 8 月 16 日に対応する date 値が返されます。
let $mydate := xs:date("2003-08-16")
<year>{xf:get-year-from-date($mydate)}</year>
<month>{xf:get-month-from-date($mydate)}</month>
<day>{xf:get-day-from-date($mydate)}</day>
date("2003-08-16Z")
を呼び出すと、次のクエリ例に示すように、UTC タイム ゾーンで 2003 年 8 月 16 日に対応する date 値が返されます。
let $mydate := xs:date("2003-08-16Z")
<year>{xf:get-year-from-date($mydate)}</year>
<month>{xf:get-month-from-date($mydate)}</month>
<day>{xf:get-day-from-date($mydate)}</day>
注意 : | date 文字列にある Z は、日付が UTC タイム ゾーンで指定されていることを示します。 |
date("2003-08-16-02:00")
を呼び出すと、次のクエリ例に示すように、UTC から 2 時間遅れているタイム ゾーンでの 2003 年 8 月 16 日に対応する date 値が返されます。
let $mydate := xs:date("2003-08-16-02:00")
<year>{xf:get-year-from-date($mydate)}</year>
<month>{xf:get-month-from-date($mydate)}</month>
<day>{xf:get-day-from-date($mydate)}</day>
date("2003-04-31")
を呼び出すと、2003 年 4 月 31 日は有効な日付ではない (4 月に 31 日はない) ため、エラーが出力されます。
<result>{xs:date("2003-04-31")}</result>
XQuery を実行中にエラーが発生しました : "2003-04-31" を型 [date@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
date("2003-8-16")
を呼び出すと、月が 2 桁で指定されていないため、エラーが出力されます。
<result>{xs:date("2003-8-16")}</result>
XQuery を実行中にエラーが発生しました : "2003-8-16" を型 [date@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
W3C の date データ型の説明。
$string-var
(time フォーマットの文字列) を time データ型に変換します。
$string-var
の値が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
$string-var
の値が有効な time フォーマットでない場合、次のエラーが表示されます。
"invalid_time_string"
を型
[time@htttp://www.w3.org/2001/XMLSchema] にキャストできませんでした。
ここで、invalid_time_string は time フォーマットで有効でない文字列 (たとえば "23:5:44"
) です。
xs:
time(xs:
string $string-var)—>xs: time
time("23:15:45")
を呼び出すと、現在のタイム ゾーンで午後 11 時 15 分 45 秒に対応する time 値が返されます。
let $mytime := xs:time("23:15:45")
<hours>{xf:get-hours-from-time($mytime)}</hours>
<minutes>{xf:get-minutes-from-time($mytime)}</minutes>
<seconds>{xf:get-seconds-from-time($mytime)}</seconds>
time("23:15:45Z")
を呼び出すと、UTC タイム ゾーンで午後 11 時 :15 分 45 秒に対応する time 値が返されます。
let $mytime := xs:time("23:15:45Z")
<hours>{xf:get-hours-from-time($mytime)}</hours>
<minutes>{xf:get-minutes-from-time($mytime)}</minutes>
<seconds>{xf:get-seconds-from-time($mytime)}</seconds>
time("23:5:44")
を呼び出すと、分が 2 桁で指定されていないため、エラーが出力されます。
<result>{xs:time("23:5:44")}</result>
XQuery を実行中にエラーが発生しました : "23:5:44" を型 [time@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
W3C の time データ型の説明。
$string-var
(gYearMonth フォーマットの文字列) を gYearMonth データ型に変換します。
$string-var
の値が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
$string-var
の値が有効な gYearMonth フォーマットでない場合、次のエラーが表示されます。
"invalid_gYearMonth_string"
を型
[gYearMonth@htttp://www.w3.org/2001/XMLSchema] にキャストできませんでした。
ここで、invalid_gYearMonth_string は time フォーマットで有効でない文字列 (たとえば "2003-8"
) です。
xs:
gYearMonth(xs:
string $string-var)—> xs: gYearMonth
指定された年と月を gYearMonth データ型で返します。
gYearMonth("2003-08")
を呼び出すと、次のクエリ例に示すように、2003 年 8 月に対応する gYearMonth 値が返されます。
<result>{xs:gYearMonth("2003-08")}</result>
gYearMonth("2003-08Z")
を呼び出すと、次のクエリ例に示すように、UTC タイム ゾーンで 2003 年 8 月に対応する gYearMonth 値が返されます。
<result>{xs:gYearMonth("2003-08Z")}</result>
gYearMonth("2003-8")
を呼び出すと、月が 2 桁で指定されていないため、エラーが出力されます。
<result>{xs:gYearMonth("2003-8")}</result>
XQuery を実行中にエラーが発生しました : "2003-8" を型 [gYearMonth@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
W3C の gYearMonth データ型の説明。
$string-var
(gYear フォーマットの文字列) をgYear データ型に変換します。
$string-var
の値が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
$string-var
の値が有効な gYear フォーマットでない場合、次のエラーが表示されます。
"invalid_gYear_string"
を型 [gYear@htttp://www.w3.org/2001/XMLSchema] にキャストできませんでした。
ここで、invalid_gYear_string は time フォーマットで有効でない文字列 (たとえば "20-2003"
) です。
xs:
gYear(xs:
string $string-var)—> xs:
gYear
gYear("2003")
を呼び出すと、次のクエリ例に示すように、2003 年に対応する gYear 値が返されます。
<result>{xs:gYear("2003")}</result>
gYear("2003Z")
を呼び出すと、次のクエリ例に示すように、UTC タイム ゾーンで 2003
年に対応する gYear 値が返されます。
<result>{xs:gYear("2003Z")}</result>
W3C の gYear データ型の説明。
$string-var
(gMonthDay フォーマットの文字列) を gMonthDay データ型に変換します。
$string-var
の値が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()」であり、SQL の null のようなものです。
$string-var
の値が有効な gMonthDay フォーマットでない場合、次のエラーが表示されます。
"invalid_gMonthDay_string"
を型 [gMonthDay@htttp://www.w3.org/2001/XMLSchema] にキャストできませんでした。
ここで、invalid_gMonthDay_string は time フォーマットで有効でない文字列 (たとえば "08-15") です。
xs:
gMonthDay(xs:
string $string-var)—> xs:gMonthDay
指定された月と日を gMonthDay データ型で返します。
gMonthDay("--08-15")
を呼び出すと、次のクエリ例に示すように、8 月 15 日に対応する gMonthDay 値が返されます。
<result>{xs:gMonthDay("--08-15")}</result>
gMonthDay("--08-15Z")
を呼び出すと、次のクエリ例に示すように、UTC タイム ゾーンで 8 月 15 日に対応する gMonthDay 値が返されます。
<result>{xs:gMonthDay("--08-15Z")}</result>
gMonthDay("08-15")
を呼び出すと、--
プレフィックスがないため、エラーが出力されます。
<result>{xs:gMonthDay("08-15")}</result>
XQuery を実行中にエラーが発生しました : "08-15" を型 [gMonthDay@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
W3C の gMonthDay データ型の説明。
$string-var
(gMonth フォーマットの文字列) を gMonth データ型に変換します。
$string-var
の値が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()」であり、 SQL の null のようなものです。
$string-var
の値が有効な gMonth フォーマットでない場合、次のエラーが表示されます。
"invalid_gMonth_string"
を型 [gMonth@htttp://www.w3.org/2001/XMLSchema] にキャストできませんでした。
ここで、invalid_gMonth_string は time フォーマットで有効でない文字列 (たとえば "08") です。
xs:
gMonth(xs:
string $string-var)—> xs:gMonth
gMonth("--08--")
を呼び出すと、次のクエリ例に示すように、8 月に対応する gMonth 値が返されます。
<result>{xs:gMonth("--08--")}</result>
gMonth("--08--Z")
を呼び出すと、次のクエリ例に示すように、UTC タイム ゾーンで 8 月に対応する gMonth 値が返されます。
<result>{xs:gMonth("--08--Z")}</result>
gMonth("08")
を呼び出すと、--
プレフィックスがないため、エラーが出力されます。
<result>{xs:gMonth("08")}</result>
XQuery を実行中にエラーが発生しました : "08" を型 [gMonth@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
W3C の gMonth データ型の説明。
$string-var
(gDay フォーマットの文字列) を gDay データ型に変換します。
$string-var
の値が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()」であり、SQL の null のようなものです。
$string-var
の値が有効な gDay フォーマットでない場合、次のエラーが表示されます。
"invalid_gDay_string"
を型 [gDay@htttp://www.w3.org/2001/XMLSchema] にキャストできませんでした。
ここで、invalid_gDay_string は time フォーマットで有効でない文字列 (たとえば "15") です。
xs:
gDay(xs:
string $string-var)—>xs:gDay
gDay("---15")
を呼び出すと、次のクエリ例に示すように、月の 15 日目に対応する gDay 値が返されます。
<result>{xs:gDay("---15")}</result>
gDay("---15Z")
を呼び出すと、次のクエリ例に示すように、UTC タイム ゾーンで月の 15 日目に対応する gDay 値が返されます。
<result>{xs:gDay("---15Z")}</result>
gDay("15")
を呼び出すと、---
プレフィックスがないため、エラーが出力されます。
<result>{xs:gDay("15")}</result>
XQuery を実行中にエラーが発生しました : "15" を型 [gDay@http://www.w3.org/2001/XMLSchema] にキャストできませんでした。
W3C の gDay データ型の説明。
$string-var
(duration フォーマットの文字列) を duration データ型に変換します。
$string-var
の値が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
xs:
duration(xs:
string $string-var)—> xs:duration
経過時間 (期間) を duration 値として返します。
duration("P1Y2M4DT9H8M20S")
を呼び出すと、次のクエリ例に示すように、1 年 2 か月 4 日と 9 時間 8 分 20 秒に対応する duration 値が返されます。
<result>{xs:duration("P1Y2M4DT9H8M20S")}</result>
<result>P1Y2M4DT9H8M20S</result>
duration("P9Y")
を呼び出すと、次のクエリ例に示すように、9 年に対応する duration 値が返されます。
<result>{xs:duration("P9Y")}</result
>
duration("-P10M")
を呼び出すと、次のクエリ例に示すように、負の 10 か月に対応する duration 値が返されます。
<result>{xs:duration("-P10M")}</result>
duration("P4DT20S")
を呼び出すと、次のクエリ例に示すように、4 日と 20 秒に対応する duration 値が返されます。
<result>{xs:duration("P4DT20S")}</result>
W3C の duration データ型の説明。
URI (Uniform Resource Identifier Reference) を含む $string-var
を anyURI データ型に変換します。
$string-var
の値が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
xs:
anyURI(xs:
string $string-var)—>xs: anyURI
anyURI データ型に変換された $string-var
が返されます。
<result>{xs:anyURI("http://www.acme.org/")}</result>
<result>http://www.acme.org/</result>
W3C の anyURI データ型の説明。
$string-var
を Name データ型に変換します。
$string-var
の値が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
xs:
Name(xs:
string $string-var)—> xs: Name
Name データ型に変換された $string-var
が返されます。
W3C の Name データ型の説明。
$string-var
で指定したローカル名を持ち、ネームスペースを持たない新しい QName を作成します。
$string-var
の値が空のシーケンスである場合は、空のシーケンスが返されます。空のシーケンスとは項目を含まないシーケンス「()
」であり、SQL の null のようなものです。
xs:
QName(xs:
string $string-var)—> xs: QName
QName データ型に変換された $string-var
が返されます。
W3C の QName データ型の説明。
![]() ![]() ![]() |