Number.Round

Syntax

Number.Round(
    number as nullable number,
    optional digits as nullable number,
    optional roundingMode as nullable number
) as nullable number

About

返回舍入 number 到最接近的数字的结果。 如果 number 为 null, Number.Round 则返回 null。

默认情况下, number 将舍入为最接近的整数,并且通过舍入到最接近的偶数(使用 RoundingMode.ToEven(也称为“银行家舍入”)来破坏关系。

但是,可以通过以下可选参数重写这些默认值。

  • digits:导致 number 舍入为指定的十进制数字数。
  • roundingMode:当处于两个潜在舍入值之间的中间点时,重写默认的断点行为 number (请参阅 RoundingMode.Type 可能的值)。

示例 1

将 1.234 舍入为最接近的整数。

用法

Number.Round(1.234)

输出

1

示例 2

将 1.56 舍入到最接近的整数。

用法

Number.Round(1.56)

输出

2

示例 3

将 1.2345 舍入到两个小数位数。

用法

Number.Round(1.2345, 2)

输出

1.23

示例 4

第 1.2345 轮到三个小数位数(向上舍入)。

用法

Number.Round(1.2345, 3, RoundingMode.Up)

输出

1.235

示例 5

第 1.2345 轮到三个小数位数(向下舍入)。

用法

Number.Round(1.2345, 3, RoundingMode.Down)

输出

1.234