BigDecimal 中 关于RoundingMode介绍

RoundingMode介绍

RoundingMode是一个枚举类，有以下几个常量：UP、DOWN、CEILING、FLOOR、HALF_UP、HALF_DOWN、HALF_EVEN、UNNECESSARY；

UP(BigDecimal.ROUND_UP):

远离零方向舍入的舍入模式(可以理解为向上取整)。此舍入模式始终不会减少计算值的绝对值。

输入值	使用up舍入模式的输出值
5.5	6
2.5	3
1.6	2
1.1	2
1.0	1
-1.0	-1
-1.1	-2
-1.6	-2
-2.5	-3
-5.5	-6

DOWN(BigDecimal.ROUND_DOWN):

向零方向舍入的舍入模式(可以理解为向下取整)。此舍入模式始终不会增加计算值的绝对值。

输入值	使用DOWN舍入模式的输出值
5.5	5
2.5	2
1.6	1
1.1	1
1.0	1
-1.0	-1
-1.1	-1
-1.6	-1
-2.5	-2
-5.5	-5

CEILING(BigDecimal.ROUND_CEILING)：

向正无限大方向舍入的舍入模式。如果结果为正，则向上取整；如果结果为负，则向下取整。此舍入模式始终不会减少计算值。

输入值	使用CEILING舍入模式的输出值
5.5	6
2.5	3
1.6	2
1.1	2
1.0	1
-1.0	-1
-1.1	-1
-1.6	-1
-2.5	-2
-5.5	-5

FLOOR(BigDecimal.ROUND_FLOOR):

向负无限大方向舍入的舍入模式。如果结果为正，则向下去整；如果结果为负，则向上取整。此舍入模式始终不会增加计算值。

输入值	使用FLOOR舍入模式的输出值
5.5	5
2.5	2
1.6	1
1.1	1
1.0	1
-1.0	-1
-1.1	-2
-1.6	-2
-2.5	-3
-5.5	-6

HALF_UP(BigDecimal.ROUND_HALF_UP)：

向最接近数字方向舍入的舍入模式，如果与两个相邻数字的距离相等，则向上舍入。如果被舍弃部分 >= 0.5，则向上取正；否则向下取整。此舍入模式即四舍五入。

输入值	使用HALF_UP舍入模式的输出值
5.5	6
2.5	3
1.6	2
1.1	1
1.0	1
-1.0	-1
-1.1	-1
-1.6	-2
-2.5	-3
-5.5	-6

 

HALF_DOWN(BigDecimal.ROUND_HALF_DOWN):

向最接近数字方向舍入的舍入模式，如果与两个相邻数字的距离相等，则向下舍入。如果被舍弃部分 > 0.5，则向上取整；否则向下取整。

输入值	使用HALF_DOWN舍入模式的输出值
5.5	5
2.5	2
1.6	2
1.1	1
1.0	1
-1.0	-1
-1.1	-1
-1.6	-2
-2.5	-2
-5.5	-5

HALF_EVEN(BigDecimal.ROUND_HALF_EVEN):

向最接近数字方向舍入的舍入模式，如果与两个相邻数字的距离相等，则向相邻的偶数舍入。如果舍弃部分左边的数字为奇数，则舍入行为同 RoundingMode.HALF_UP；如果为偶数，则舍入行为同RoundingMode.HALF_DOWN。注意，在重复进行一系列计算时，此舍入模式可以在统计上将累加错误减到最小。此舍入模式也称为“银行家舍入法”，主要在美国使用。此舍入模式类似于 Java 中对float 和double 算法使用的舍入策略。

输入值	使用HALF_EVEN舍入模式的输出值
5.5	6
2.5	2
1.6	2
1.1	1
1.0	1
-1.0	-1
-1.1	-1
-1.6	-2
-2.5	-2
-5.5	-6

UNNECESSARY(BigDecimal.ROUND_UNNECESSARY):

用于断言请求的操作具有精确结果的舍入模式，因此不需要舍入。如果需要舍入，则抛出 ArithmeticException。

输入值	使用UNNECESSARY舍入模式的输出值
5.5	throw ArithmeticException
2.5	throw ArithmeticException
1.6	throw ArithmeticException
1.1	throw ArithmeticException
1.0	1
-1.0	-1
-1.1	throw ArithmeticException
-1.6	throw ArithmeticException
-2.5	throw ArithmeticException
-5.5	throw ArithmeticException