由 BigDecimal 舍入算法引发的血案：ROUND_HALF_UP 与 ROUND_UP

青旅半醒 2024-04-08 11:11 108阅读 0赞

### 背景 ###

项目里最近新增了一个 Excel 导入功能，要求：保存 Excel 展示出来的数据。

**原格式如下**：

![b5955631592141648ae52d8ebf03aa3c.png][]

你以为所见即所得吗？不不不，我们看到的数据实际上是 Excel 做了显示隐藏的功能，程序读出来的确实原始数据，比如【76.3%】这个数据，实际长这样【0.763490452069129】。

**实际格式如下：**

![a399646dedc64f5ead14c41179fa5445.png][]

为了实现业务的需求，同时保证字符串的处理精度，我们在业务层用 BigDecimal 函数对 EasyExcel 读到的数据做了一层预处理。

**预处理代码如下：**

private String dataFormat_2(String num) {
            return new BigDecimal(num).setScale(3, BigDecimal.ROUND_UP) + "";
        }

--------------------

### 问题 ###

从 Excel 的原始数据可以看出，业务方需要我们的处理格式为：四舍五入，保留3位小数。但是，使用上述手段的实际处理却没有达到预期，因为个别数据与与其不符。比如：数据【0.763490452069129】按要求应为【0.763】，实际转换结果为【0.764】。

后来仔细查询了 BigDecimal 的官方文档，明白是用错了方法导致的，希望小伙伴们不要犯同样的错误，真正的四舍五入应该用【**ROUND\_HALF\_UP**】：

private String dataFormat_1(String num) {
            return new BigDecimal(num).setScale(3, BigDecimal.ROUND_HALF_UP) + "";
        }

**两种方法的导入结果做了对比：**

![f506e25345dd4b39a5fc611bfdfda3cc.png][]

--------------------

### 总结 ###

BigDecimal 的舍位运算 setScale(scale, roundingMode)方法中：scale表示精确位数，roundingMode表示舍入模式。其中，【**舍入模式**】**常见的模式有四种：**

1.  ROUND\_UP：进位制，不管保留数字后面是大是小（0除外）都会进位；
2.  ROUND\_DOWN：保留设置数字，后面所有直接去除；
3.  ROUND\_HALF\_UP：根据保留数字后一位进行四舍五入（ >=5 进位）；
4.  ROUND\_HALF\_DOWN：根据保留数字后一位进行四舍五入（>5进位）。

// 舍位运算
    	@Test
    	public void testCarry() {
    		BigDecimal bigNum = new BigDecimal("2.35");		
    		//进位处理，2.31变成2.4 
    		System.out.println("ROUND_UP："+bigNum.setScale(1,BigDecimal.ROUND_UP));	
    		//直接删除多余的小数位，如2.35会变成2.3 
    		System.out.println("ROUND_DOWN："+bigNum.setScale(1,BigDecimal.ROUND_DOWN));	
    		//四舍五入，2.35变成2.4
    		System.out.println("ROUND_HALF_UP："+bigNum.setScale(1,BigDecimal.ROUND_HALF_UP));
    		//五舍六入，2.35变成2.3
            System.out.println("ROUND_HALF_DOWN："+bigNum.setScale(1,BigDecimal.ROUND_HALF_DOWN));
    		//不建议使用的.setScale(1)方法
    		System.out.println("setScale："+bigNum.setScale(2));
    	}

**BigDecimal的详细用法，见博客：**

[Java中BigDecimal类的使用方法详解，常用最全系列！\_Java Punk的博客-CSDN博客Java在java.math包中提供的API类BigDecimal，用来对超过16位有效位的数进行精确的运算。对于Double类型的运算，通常使用此类处理，来有效避免精度问题。我们从以下五个功能点，来细说使用方法和注意事项：正文：基本运算注意事项：BigDecimal的加减乘除操作，其实最终返回的都是一个新的BigDecimal对象，因为BigDecimal都是不可变的的（BigInte...![favicon32.ico][]https://blog.csdn.net/weixin\_44259720/article/details/87001849][Java_BigDecimal_Java Punk_-CSDN_Java_java.math_API_BigDecimal_16_Double_BigDecimal_BigDecimal_BigDecimal_BigInte..._favicon32.ico_https_blog.csdn.net_weixin_44259720_article_details_87001849]希望可以帮到你 ~ ~ ~

--------------------

[b5955631592141648ae52d8ebf03aa3c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/c9d3a6a62cc7420fbc336fe8aa4d0d77.png
[a399646dedc64f5ead14c41179fa5445.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/4e061e7484974efb88796edf2bb471b5.png
[f506e25345dd4b39a5fc611bfdfda3cc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/b7b5d207999f4e929846224dfa09c190.png
[favicon32.ico]: https://g.csdnimg.cn/static/logo/favicon32.ico
[Java_BigDecimal_Java Punk_-CSDN_Java_java.math_API_BigDecimal_16_Double_BigDecimal_BigDecimal_BigDecimal_BigInte..._favicon32.ico_https_blog.csdn.net_weixin_44259720_article_details_87001849]: https://blog.csdn.net/weixin_44259720/article/details/87001849