数値関数 - round

適用対象:SQL Server

引数に最も近く、小数部分を持たない数値を返します。 このような数値が複数ある場合は、正の無限大に最も近いものが返されます。 次に例を示します。

引数が 2.5 の場合、 round() は 3 を返します。

引数が 2.4999 の場合、 round() は 2 を返します。

引数が -2.5 の場合、 round() は -2 を返します。

引数が空のシーケンスの場合、 round() は空のシーケンスを返します。

構文

  
fn:round ( $arg as numeric?) as numeric?  

引数

$arg
関数が適用される数値。

解説

$argの型が xs:float、xs:double、または xs:decimal の 3 つの数値基本型のいずれかである場合、戻り値の型は$arg型と同じです。 $argの型が数値型の 1 つから派生した型である場合、戻り値の型は基本数値型です。

fn:floorfn:ceiling、または fn:round 関数への入力が xdt:untypedAtomic、型指定されていないデータである場合、暗黙的に xs:double にキャストされます。

その他の型のデータが入力されると、静的エラーが生成されます。

このトピックでは、AdventureWorks データベースのさまざまな xml 型列に格納されている XML インスタンスに対する XQuery の例を示します。

作業サンプルは、round() XQuery 関数の ceiling 関数 (XQuery) で使用できます。 クエリの ceiling() 関数を round() 関数に置き換える必要があります。

実装の制限事項

制限事項は次のとおりです。

  • round() 関数は整数値を xs:decimal にマップします。

  • -0.5e0 から -0e0 までの xs:double 値と xs:float 値の round() 関数は、-0e0 ではなく 0e0 にマップされます。

参照

floor 関数 (XQuery)
ceiling 関数 (XQuery)