Java核心类——8.BigDecimal

目录

• java.math.BigDecimal使用
  • BigDecimal构造
  • 小数位数（scale）
  • 精度控制与四舍五入
  • 运算规则
  • 比较与相等判断
  • 总结

---

java.math.BigDecimal使用

在金融、电商等对数值精度要求极高的领域，Java的基本浮点类型（float、double）往往无法满足需求，因为它们会产生精度丢失的问题。而java.math.BigDecimal类提供了完全精确的十进制浮点运算解决浮点精度丢失。

BigDecimal构造

BigDecimal其内部通过BigInteger存储整数部分，再通过scale（小数位数）来确定小数点位置，从而能够表示任意精度的小数。

创建BigDecimal的正确方式是使用字符串构造，避免使用double构造（否则会带入精度误差）：

// 推荐方式：通过字符串创建
BigDecimal correct = new BigDecimal("0.1");

// 不推荐：double本身的精度问题会被带入
BigDecimal incorrect = new BigDecimal(0.1); // 实际值可能是0.1000000000000000055...

小数位数（scale）

scale是BigDecimal的核心属性，代表小数部分的位数：

BigDecimal d1 = new BigDecimal("123.45");
BigDecimal d2 = new BigDecimal("123.4500");
BigDecimal d3 = new BigDecimal("12345");

System.out.println(d1.scale()); // 2（两位小数）
System.out.println(d2.scale()); // 4（四位小数）
System.out.println(d3.scale()); // 0（整数）

通过stripTrailingZeros()方法可以移除末尾多余的0，同时自动调整scale：

BigDecimal d = new BigDecimal("123.4500").stripTrailingZeros();
System.out.println(d.scale()); // 2（移除两个0后保留两位小数）

当scale为负数时，表示整数部分末尾有对应数量的0：

BigDecimal d = new BigDecimal("1234500").stripTrailingZeros();
System.out.println(d.scale()); // -2（表示整数1234500末尾有2个0）

精度控制与四舍五入

setScale(int newScale, RoundingMode mode)方法用于调整精度，其中RoundingMode指定舍入规则：

import java.math.RoundingMode;

BigDecimal d = new BigDecimal("123.456789");

// 保留4位小数，四舍五入
BigDecimal rounded = d.setScale(4, RoundingMode.HALF_UP); // 123.4568

// 保留4位小数，直接截断
BigDecimal truncated = d.setScale(4, RoundingMode.DOWN); // 123.4567

常用的RoundingMode包括：

• HALF_UP：四舍五入（最常用）
• DOWN：直接截断
• UP：向上进位
• HALF_EVEN：银行家舍入法（偶数位四舍五入）

运算规则

BigDecimal的四则运算通过实例方法实现，其中除法需要特别注意精度设置：

BigDecimal a = new BigDecimal("123.456");
BigDecimal b = new BigDecimal("23.456789");

// 加、减、乘运算（精度自动维护）
BigDecimal sum = a.add(b);
BigDecimal diff = a.subtract(b);
BigDecimal product = a.multiply(b);

// 除法必须指定精度和舍入模式（否则可能因除不尽报错）
BigDecimal quotient = a.divide(b, 10, RoundingMode.HALF_UP); // 保留10位小数

通过divideAndRemainder()可同时获取商和余数：

BigDecimal n = new BigDecimal("12.345");
BigDecimal m = new BigDecimal("0.12");
BigDecimal[] dr = n.divideAndRemainder(m);

System.out.println(dr[0]); // 商：102
System.out.println(dr[1]); // 余数：0.105

比较与相等判断

关键注意点：equals()方法不仅比较值，还会比较scale，而compareTo()仅比较数值大小：

BigDecimal d1 = new BigDecimal("123.456");
BigDecimal d2 = new BigDecimal("123.45600");

System.out.println(d1.equals(d2)); // false（scale不同：3 vs 5）
System.out.println(d1.compareTo(d2) == 0); // true（数值相等）

注意：始终使用compareTo()比较两个BigDecimal的值，返回值含义：

• 0：相等
• 1：当前对象更大
• -1：当前对象更小

总结

• BigDecimal用于表示精确的小数，解决了Java浮点类型的精度丢失问题。
• 比较BigDecimal的值是否相等，必须使用compareTo()而不能使用equals()。