Share via


round 函數 (XQuery)

傳回最接近引數且去掉小數部份的數字。如果這樣的數字不止一個,則傳回最接近正無限數的那一個。例如:

如果引數為 2.5,round() 傳回 3。

如果引數為 2.4999,round() 傳回 2。

如果引數為 -2.5,round() 傳回 -2。

如果引數是空的序列,round() 傳回空的序列。

語法

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

引數

  • $arg
    會套用函數的數字。

備註

如果 $arg 的類型是 xs:floatxs:doublexs:decimal 這三個數值基底類型之一,則傳回的類型與 $arg 類型相同。如果 $arg 的類型是從數值類型之一衍生而來,則傳回類型是基底數值類型。

如果 fn:floorfn:ceilingfn:round 函數的輸入是 xdt:untypedAtomic 不具類型的資料,則它會隱含地轉換為 xs:double

任何其他類型都會產生靜態錯誤。

範例

本主題針對儲存在 AdventureWorks 資料庫中之各種 xml 類型資料行的 XML 執行個體,提供 XQuery 範例。如需這些資料行的概觀,請參閱<在 AdventureWorks 資料庫中的 xml 資料類型表示法>。

您可以在 round() XQuery 函數使用上限函數 (XQuery) 中的工作範例。使用時,只要將查詢中的 ceiling() 函數取代為 round() 函數就可以了。

實作限制

以下這些是限制:

  • round() 函數會將整數值對應至 xs:decimal。

  • xs:double 的 round() 函數和介於 -0.5e0 和 -0e0 之間的 xs:float 值,會對應到 0e0 而不是 -0e0。