ROUND_BANKERS
更新时间：2025-10-17
描述
将x使用银行家舍入法后，保留 d 位小数，d默认为 0。
如果d为负数，则小数点左边d位为 0。
如果x或d为 null，返回 null。
如果 d 为一个列，并且第一个参数为 Decimal 类型，那么结果 Decimal 会跟入参 Decimal 具有相同的小数部分长度。
根据银行家舍入算法的规则，当需要舍入到指定的小数位时：
-
如果要舍入的数字是 5，且后面没有其他非零数字，则会检查前一位数字：
- 如果前一位数字是偶数，则直接舍去；
- 如果前一位数字是奇数，则向上进一。
- 如果要舍入的数字大于 5 或者其后有非 0 的数字，则按照传统的四舍五入规则进行：即大于等于 5 则进位，否则舍去。
例如：
- 对于数值 2.5，由于 5 前面的数字 2 是偶数，因此结果将舍入为 2。
- 对于数值 3.5，由于 5 前面的数字 3 是奇数，因此结果将舍入为 4。
- 对于数值 2.51，因为 5 后面的数字不是 0，所以直接进位，结果为 3。
语法
SQL
1ROUND_BANKERS(<x> [ , <d>])参数
| 参数 | 说明 |
|---|---|
<x> |
需要四舍五入的数值 |
<d> |
可选，四舍五入需要保留的小数位数，默认为 0 |
返回值
返回一个整型或者浮点数：
- 默认情况，参数 d = 0 , 返回
x根据银行家舍入算法计算过的整数。 - d 为 负数 , 返回小数点左边第一位为 0 的整数。
- x 和 d is NULL , 返回 NULL。
- d 为一个列时 , 且
x为 Decimal 类型 , 返回相同精度的浮点数。
举例
SQL
1select round_bankers(0.4);
Text
1+--------------------+
2| round_bankers(0.4) |
3+--------------------+
4| 0 |
5+--------------------+
SQL
1select round_bankers(-3.5);
Text
1+---------------------+
2| round_bankers(-3.5) |
3+---------------------+
4| -4 |
5+---------------------+
SQL
1select round_bankers(-3.4);
Text
1+---------------------+
2| round_bankers(-3.4) |
3+---------------------+
4| -3 |
5+---------------------+
SQL
1select round_bankers(10.755, 2);
Text
1+--------------------------+
2| round_bankers(10.755, 2) |
3+--------------------------+
4| 10.76 |
5+--------------------------+
SQL
1select round_bankers(10.745, 2);
Text
1+--------------------------+
2| round_bankers(10.745, 2) |
3+--------------------------+
4| 10.74 |
5+--------------------------+
SQL
1select round_bankers(1667.2725, -2);
Text
1+------------------------------+
2| round_bankers(1667.2725, -2) |
3+------------------------------+
4| 1700 |
5+------------------------------+
SQL
1SELECT number
2, round_bankers(number * 2.5, number - 1) AS rb_decimal_column
3, round_bankers(number * 2.5, 0) AS rb_decimal_literal
4, round_bankers(cast(number * 2.5 AS DOUBLE), number - 1) AS rb_double_column
5, round_bankers(cast(number * 2.5 AS DOUBLE), 0) AS rb_double_literal
6FROM test_enhanced_round
7WHERE rid = 1;
Text
1+--------+-------------------+--------------------+------------------+-------------------+
2| number | rb_decimal_column | rb_decimal_literal | rb_double_column | rb_double_literal |
3+--------+-------------------+--------------------+------------------+-------------------+
4| 1 | 2.0 | 2 | 2 | 2 |
5+--------+-------------------+--------------------+------------------+-------------------+