ROUND- Cosmos DB 中的查詢語言(在 Azure 與 Fabric 中)

函 ROUND 數會回傳一個數值,並將其四捨五入至最接近的整數值或第二個可選參數所指示的精度。

Azure Cosmos 資料庫系統的函式,回傳四捨五入至最接近整數的數字。

語法

ROUND(<numeric_expr1> [, <numeric_expr2>])

Arguments

Description
numeric_expr1 一個數值表達式,用來四捨五入。
numeric_expr2 (選用) 一個數值表達式,用來設定四捨五入的精度。 正值會四捨五入到小數點右邊的同位數,四 0 捨五入到最接近的整數,負數值則四捨五入到小數點左側。 若省略,該值會四捨五入至最接近的整數。

傳回類型

傳回數值運算式。

範例

本節包含如何使用此查詢語言建構的範例。

將數字四捨五入到最接近的整數

在此範例中,正數和負數會四捨五入至最接近的整數。

SELECT VALUE {
  roundTwoPointFour: ROUND(2.4),
  roundTwoPointSix: ROUND(2.6),
  roundTwoPointFive: ROUND(2.5),
  roundNegativeTwoPointFour: ROUND(-2.4),
  roundNegativeTwoPointSix: ROUND(-2.6)
}
[
  {
    "roundTwoPointFour": 2,
    "roundTwoPointSix": 3,
    "roundTwoPointFive": 3,
    "roundNegativeTwoPointFour": -2,
    "roundNegativeTwoPointSix": -3
  }
]

四捨五入至指定精度

以下範例使用可選的第二個參數來控制四捨五入精度。

SELECT VALUE {
    case1: ROUND(1234567, -2),
    case2: ROUND(1234567, 0),
    case3: ROUND(1234567, 2),
    case4: ROUND(1234.567, -2),
    case5: ROUND(1234.567, 0),
    case6: ROUND(1234.567, 2)
}
[
  {
    "case1": 1234600,
    "case2": 1234567,
    "case3": 1234567,
    "case4": 1200,
    "case5": 1235,
    "case6": 1234.57
  }
]

備註

  • 此功能受益於範圍索引的使用。 如需詳細資訊,請參閱 範圍索引。
  • 執行的四捨五入運算會遵循遠離零的中間點四捨五入。 如果輸入是正好介於兩個整數之間的數值運算式,則結果是距離 0 的最接近的整數值。 例如 -6.5 to -7, -0.5 to -1, 0.5 to 1, 6.5 to 7 。