XML スキーマ・データ・タイプ間のキャスト

データ・タイプ・コンストラクター関数を使用して、値を特定のデータ・タイプにキャストすることができます。 キャストする値とキャストするタイプを指定します。

以下の表に、キャストの互換タイプをリストします。リストされている入力タイプの値のみを 各ターゲット・タイプにキャストすることができます。

表 1. キャストの互換タイプ
ターゲット・タイプ ソース・タイプ コメント
xs:untypedAtomic すべてのタイプ  
xs:string すべてのタイプ
  • ソース・タイプが xs:boolean の場合、結果は true または false です。
  • ソース・タイプが xs:integer の場合、結果は、XML スキーマ仕様で定義されている、値の正規字句表記です。
  • ソース・タイプが xs:decimal の場合:
    • 値の小数点以降に有効数字が無い場合、小数点および小数点以降のゼロは削除されます。 xs:integer からのキャストの規則が適用されます。
    • それ以外の場合、結果は、XML スキーマ仕様で定義されている、値の正規字句表記です。
  • ソース・タイプが xs:double の場合:
    • .000001<=value<=1000000 の場合、値は xs:decimal に変換され、 xs:decimal からのキャストの規則が適用されます。
    • value=+0 または value=-0 の場合、結果は '0' です。
    • それ以外の場合、結果は、XML スキーマ仕様で定義されている、値の正規字句表記です。
  • ソース・タイプが xs:yearMonthDuration または xs:dayTimeDuration の場合、結果は、値の正規字句表記です。
  • ソース・タイプが xs:date、xs:dateTime、または xs:time の場合、結果は、時間帯の調整を含まない値の正規字句表記です。 値に時間帯がない場合、 結果にも時間帯はありません。時間帯が +00:00 または -00:00 の場合、 結果は UTC 時間帯「Z」を含みます。
xs:boolean xs:untypedAtomic、 xs:string、 xs:boolean、 xs:double、 xs:decimal、 xs:integer
  • ソース・タイプが numeric の場合、値 0 または NaN は、タイプ xs:boolean にキャストされ、 値は false になります。
  • ソース・タイプが xs:string または xs:untypedAtomic の場合、値 "true" および値 "1" は xs:boolean 値 true にキャストされます。 値 "false" および値 "0" は、xs:boolean 値 false にキャストされます。 それ以外の値はすべて無効で、結果はエラーになります。
xs:dayTimeDuration xs:duration、xs:untypedAtomic、
xs:string
xs:duration から xs:dayTimeDuration にキャストすると 情報が失われます。情報が失われないようにするには、xs:duration 値を xs:yearMonthDuration 値と xs:dayTimeDuration 値にキャストし、両方の値を処理してください。
xs:decimal 数値タイプ、xs:untypedAtomic、 xs:string、 xs:boolean 数値タイプの値は、タイプ xs:decimal に有効な範囲の値で 数値的に最もソースに近い値に変換されます。 2 つの値が同距離の近似値である場合は、ゼロに近い方の値になります。 ソース値は、+INF、-INF、NaN、またはタイプ xs:decimal の範囲外であってはなりません。 タイプ xs:boolean の値の場合、true は 1.0 に、false は 0.0 に変換されます。
xs:double 数値タイプ、xs:untypedAtomic、 xs:string、 xs:boolean ソースがタイプ xs:decimal または xs:integer の場合、 キャストは xs:double(SV cast as xs:string) として行われます。 ここで、SV はソース値です。ソースがタイプ xs:boolean の場合、 true は値 1.0E0 に、false は値 0.0E0 にキャストされます。
xs:duration xs:dayTimeDuration、
xs:yearMonthDuration、
xs:untypedAtomic、xs:string
  • ソース・タイプが xs:dayTimeDuration の場合、ターゲット値は、ソース値と同じ日、時間、分、および秒のコンポーネントを持ちます。ターゲット値の年コンポーネントおよび月コンポーネントは 0 です。
  • ソース・タイプが xs:yearMonthDuration の場合、ターゲット値は、ソース値と同じ年および月のコンポーネントを持ちます。日、時間、分、および秒のコンポーネントは 0 です。
xs:integer 数値タイプ、xs:untypedAtomic、 xs:string、 xs:boolean ソース・タイプが整数以外の数値タイプである場合、 結果はソース値から小数部分が廃棄された値になります。 ソースは、タイプ xs:integer の範囲外であってはなりません。タイプ xs:boolean の値の場合、 true は 1 に、false は 0 に変換されます。
xs:date xs:dateTime、xs:untypedAtomic、
xs:string
ソース値の時刻部は変換に使用されません。
xs:time xs:dateTime、xs:untypedAtomic、
xs:string
ソース値の日付部は変換に使用されません。
xs:dateTime xs:date、xs:untypedAtomic、
xs:string
ターゲット値の時刻部は、その日の最初の瞬間です。時間帯による値の調整はありません。
xs:yearMonthDuration xs:duration、xs:untypedAtomic、
xs:string
xs:duration から xs:yearMonthDuration にキャストすると 情報が失われます。情報が失われないようにするには、xs:duration 値を xs:yearMonthDuration 値と xs:dayTimeDuration 値にキャストし、両方の値を処理してください。

例

以下の XQuery 式は、複数の項目が含まれている購入注文を戻します。xs:integer コンストラクター関数は、数量エレメントの値を整数にキャストします。 次に、その整数が整数 1 と比較されます。
declare namespace ipo="http://www.example.com/IPO";
/ipo:purchaseOrder[items/item/quantity/xs:integer(.) > 1]
パス式の結果が 明示的に整数にキャストされない場合、Db2® は、両方のオペランドをタイプ xs:double に変換して数値比較を行います。キャストにより、値が確実にタイプ xs:integer の値として比較されます。