Java数据类型系列之BigDecimal（Java数据类型系列之BigDecimal）

BigDecimal

这篇文章我们会介绍一下Java 中的BigDecimal,并且会通过一些例子演示它的用法，例如精度的操作

Java在Java.math包中提供的API类BigDecimal，用来对超过16位有效位的数进行精确的运算。双精度浮点型变量double可以处理16位有效数，但在实际应用中，可能需要对更大或者更小的数进行运算和处理。一般情况下，对于那些不需要准确计算精度的数字，我们可以直接使用Float和Double处理，但是Double.valueOf(String) 和Float.valueOf(String)会丢失精度。所以开发中，如果我们需要精确计算的结果，则必须使用BigDecimal类来操作。

为什么需要BigDecimal

前面学习基本类型的时候,我们可以使用float 和 double来表示浮点型数字，但是这里有一个问题那就是基本数据类型float 和 double不应该用于高精度数据的表示，例如货币，因为浮点类型的float 和 double会丢失数据的精度

double d1 = 374.56; double d2 = 374.26; System.out.println( "d1 - d2 = " ( d1 - d2 ));

这里本应输出的是0.30，但是实际上输出如下

d1 - d2 = 0.30000000000001137

这就是为什么在金融相关的程序里数据类型如此重要的原因，所以我们更好的选择是BigDecimal 而不是float 和 double

Java BigDecimal 类

BigDecimal 是不可变的，任意精度的有符号十进制类型的数字，可用于货币计算

上面那个例子如果我们是使用BigDecimal来代替double 我们可以获得准确的值

BigDecimal bd1 = new BigDecimal("374.56"); BigDecimal bd2 = new BigDecimal("374.26"); System.out.println("bd1 - bd2 = " bd1.subtract(bd2));

现在输出就和预期的一样了

bd1 - bd2 = 0.30

Java 中的BigDecimal类继承自Number并且实现了Comparable接口

public class BigDecimal extends Number implements Comparable<BigDecimal> { }

BigDecimal 类的构造方法

BigDecimal 提供了很多的构造方法，可以使用int ,char[],BigDecimal,String,doble ,long,int来初始化BigDecimal，BigDecimal 总共提供了18种构造方法，需要注意的实如果使用double 来初始化BigDecimal或许会再次引入精度的问题，下面提供了一个例子

BigDecimal bde = new BigDecimal(23.12); System.out.println("" bde.toString());

输出结果是这样的

23.120000000000000994759830064140260219573974609375

Thus it is always safe to go with a constructor that takes String as argument when representing a decimal value.

因此使用String 做为构造函数的参数来表示一个十进制的数字的时候总是安全的

BigDecimal bde = new BigDecimal("23.12"); System.out.println("" bde.toString());

Output

23.12

BigDecimal 的精度

使用BigDecimal的一个理由是BigDecimal提供了精度控制(小数点后的数字的多少)和舍入模式，为了确定小数点后的保留几位数字你可以使用setScale(int scale) 方法，但是最好的是在使用精度的时候提供舍入模式，也就是setScale的重载方法

• setScale(int newScale, int roundingMode)
• setScale(int newScale, RoundingMode roundingMode)

接下来我们通过一个例子演示一下我们为什么要这样做，假设我们在通过一个double值构造一个BigDecimal

BigDecimal bde = new BigDecimal(23.12); System.out.println("Value- " bde.toString()); System.out.println("Scaled value- " bde.setScale(1).toString());

Output

Value- 23.120000000000000994759830064140260219573974609375 Exception in thread "main" java.lang.ArithmeticException: Rounding necessary at java.base/java.math.BigDecimal.commonNeedIncrement(BigDecimal.java:4495) at java.base/java.math.BigDecimal.needIncrement(BigDecimal.java:4702) at java.base/java.math.BigDecimal.divideAndRound(BigDecimal.java:4677) at java.base/java.math.BigDecimal.setScale(BigDecimal.java:2811) at java.base/java.math.BigDecimal.setScale(BigDecimal.java:2853) at org.netjs.Programs.App.main(App.java:15)

从上面的输出中我们看到进度已经丢失了，输出的BigDecimal 是23.120000000000000994759830064140260219573974609375

并且我们看到当我们将精度设置为1 的时候并且没有提供舍入机制的时候导致Arithmetic异常被抛出

BigDecimal 的舍入模式

如果你注意到了上面我们在讲精度设置的时候，它其实是有两个设置精度的重载方法，第二个参数代表的就是舍入模式模式的参数，BigDecimal提供了八种舍入模式，它们通过static final int 进行表示

public final static int ROUND_UP = 0; public final static int ROUND_DOWN = 1; public final static int ROUND_CEILING = 2; public final static int ROUND_FLOOR = 3; public final static int ROUND_HALF_UP = 4; public final static int ROUND_HALF_DOWN = 5; public final static int ROUND_HALF_EVEN = 6; public final static int ROUND_UNNECESSARY = 7;

需要注意的是在java.math包中也提供舍入模式的枚举值，需要注意的我们是推荐使用枚举值来代替使用int 类型的常量做舍入摸模式的参数

下面我们在设置进度的同时设置一下舍入模式，来避免Arithmetic异常

@Test public void scale() { BigDecimal bde = new BigDecimal(23.12); System.out.println("Scaled value- " bde.setScale(1,1).toString()); }

但是我们说了，我们推荐使用枚举值的舍入模式，而不是直接使用int 类型的常量，接下来我们看一下RoundingMode 提供的枚举值

• CEILING- Rounding mode to round towards positive infinity.
• DOWN- Rounding mode to round towards zero.
• FLOOR- Rounding mode to round towards negative infinity.
• HALF_DOWN- Rounding mode to round towards "nearest neighbor" unless both neighbors are equidistant, in which case round down.
• HALF_EVEN- Rounding mode to round towards the "nearest neighbor" unless both neighbors are equidistant, in which case, round towards the even neighbor.
• HALF_UP- Rounding mode to round towards "nearest neighbor" unless both neighbors are equidistant, in which case round up.
• UNNECESSARY - Rounding mode to assert that the requested operation has an exact result, hence no rounding is necessary.
• UP- Rounding mode to round away from zero.

下面我们通过例子来总结一下这些舍入模式的舍入方式

	Result of rounding input to one digit with the given rounding mode
Input Number	UP	DOWN	CEILING	FLOOR	HALF_UP	HALF_DOWN	HALF_EVEN	UNNECESSARY
5.5	6	5	6	5	6	5	6	throw ArithmeticException
2.5	3	2	3	2	3	2	2	throw ArithmeticException
1.6	2	1	2	1	2	2	2	throw ArithmeticException
1.1	2	1	2	1	1	1	1	throw ArithmeticException
1.0	1	1	1	1	1	1	1	1
-1.0	-1	-1	-1	-1	-1	-1	-1	-1
-1.1	-2	-1	-1	-2	-1	-1	-1	throw ArithmeticException
-1.6	-2	-1	-1	-2	-2	-2	-2	throw ArithmeticException
-2.5	-3	-2	-2	-3	-3	-2	-2	throw ArithmeticException
-5.5	-6	-5	-5	-6	-6	-5	-6	throw ArithmeticException

更多细节参考- docs.oracle.com/javase/8/do…

BigDecimal格式化NumberFormat 格式化

由于NumberFormat类的format()方法可以使用BigDecimal对象作为其参数，可以利用BigDecimal对超出16位有效数字的货币值，百分值，以及一般数值进行格式化控制。

以利用BigDecimal对货币和百分比格式化为例。首先，创建BigDecimal对象，进行BigDecimal的算术运算后，分别建立对货币和百分比格式化的引用，最后利用BigDecimal对象作为format()方法的参数，输出其格式化的货币值和百分比。

@Test public void format() { NumberFormat currency = NumberFormat.getCurrencyInstance(); //建立货币格式化引用 NumberFormat percent = NumberFormat.getPercentInstance(); //建立百分比格式化引用 percent.setMaximumFractionDigits(3); //百分比小数点最多3位 BigDecimal loanAmount = new BigDecimal("15000.48"); //贷款金额 BigDecimal interestRate = new BigDecimal("0.008"); //利率 BigDecimal interest = loanAmount.multiply(interestRate); //相乘 System.out.println("贷款金额: " currency.format(loanAmount)); System.out.println("利率: " percent.format(interestRate)); System.out.println("利息: " currency.format(interest)); }

输出结果

贷款金额: ￥15,000.48 利率: 0.8% 利息: ￥120.00

DecimalFormat 格式化

BigDecimal格式化保留2为小数，不足则补0

@Test public void format2(){ DecimalFormat df = new DecimalFormat("#.00"); System.out.println(formatToNumber(new BigDecimal("3.435"))); System.out.println(formatToNumber(new BigDecimal(0))); System.out.println(formatToNumber(new BigDecimal("0.00"))); System.out.println(formatToNumber(new BigDecimal("0.001"))); System.out.println(formatToNumber(new BigDecimal("0.006"))); System.out.println(formatToNumber(new BigDecimal("0.206"))); } /** * @desc * 1. 0~1之间的BigDecimal小数，格式化后失去前面的0,则前面直接加上0。 * 2. 传入的参数等于0，则直接返回字符串"0.00" * 3. 大于1的小数，直接格式化返回字符串 * @return */ public String formatToNumber(BigDecimal obj) { DecimalFormat df = new DecimalFormat("#.00"); if(obj.compareTo(BigDecimal.ZERO)==0) { return "0.00"; }else if(obj.compareTo(BigDecimal.ZERO)>0&&obj.compareTo(new BigDecimal(1))<0){ return "0" df.format(obj).toString(); }else { return df.format(obj).toString(); } }

BigDecimal 例子

最常见的例子就是精度是2(小数点后保留两位)，并且采用四舍五入的舍入模式(如果指定精度的笑一个数字大于等于5则向上取整，否则向下取整)

@Test public void examples() { BigDecimal bd1 = new BigDecimal("23.126"); System.out.println("bd1 " bd1.setScale(2, RoundingMode.HALF_UP).toString()); } // 输出结果 bd1 23.13

因为精度设置为2之后，也就是小数点后两位的后一位数字是6大于等于5，所以向上取整，所以结果是 23.13

BigDecimal bd1 = new BigDecimal("23.1236"); System.out.println("bd1 " bd1.setScale(2, RoundingMode.HALF_UP).toString());

因为精度设置为2之后，也就是小数点后两位的后一位数字是3小于5，所以向下取整，所以结果是 23.12

BigDecimal bd1 = new BigDecimal("-15.567"); System.out.println("bd1 " bd1.setScale(2, RoundingMode.HALF_UP).toString());

对于负数，也是同样的道理，所以输出是bd1 -15.57

BigDecimal 的特性1. 没有重载操作符

在Java 中支持的( , -, *, /)数学运算，BigDecimal并不支持，因为这些操作符是针对基本数据类型的，但是BigDecimal是引用类型，也就是基于对象和类的，因此BigDecimal提供了下面的方法

add,subtract,multiply,and,divide

例如乘法在BigDecimal的实现如下

BigDecimal bd1 = new BigDecimal("15.567"); BigDecimal result = BigDecimal.valueOf(68).multiply(bd1); System.out.println("result " result.toString());

Output

result 1058.556

2. 使用 compareTo() 来比较BigDecimals 而不是使用 equals()

需要注意如果你使用 equals()来比较两个BigDecimal数字，那只有当两个BigDecimal的值和精度都相同的时候equals()猜认为它们是相同的(因此2.0和2.00是不相同的)

BigDecimal bd1 = new BigDecimal("2.00"); BigDecimal bd2 = new BigDecimal("2.0"); System.out.println("bd1 equals bd2 - " bd1.equals(bd2));

Output

bd1 equals bd2 - false

因此你应该使用compareTo()方法来比较两个BigDecimal 是否是相等的，BigDecimal实现了comparable接口并且提供了自己的compareTo方法，这个方法只会判断两个BigDecimal对象的值是否是相等的忽略了两个数字的精度(ike 2.0 和 2.00 相等的)

对于bd1.compareTo(bd2) 的返回值

• -1 bd1 小于 bd2.
• 0 两个相等的
• 1 bd1 大于 bd2.

BigDecimal bd1 = new BigDecimal("2.00"); BigDecimal bd2 = new BigDecimal("2.0"); System.out.println("bd1 compareTo bd2 - " bd1.compareTo(bd2));

Output

bd1 compareTo bd2 - 0

3. BigDecimals 是不可变的

BigDecimal 对象是不可变的，所以是线程安全的,在进行每一次四则运算时，都会产生一个新的对象 ，所以在做加减乘除运算时要记得要保存操作后的值。

总结

1. 当我们在进行有着高精度的计算要求的时候不要使用double和float 因为它们有着精度丢失的问题
2. 如果使用BigDecimal的时候，不要选择double值作为初始化的值，因为它同样会引入精度的问题
3. 如果你使用BigDecimal时候设置了精度，那就同时提供舍入模式，告诉BigDecimal如何舍入从而提供你想要的精度
4. BigDecimal继承了Number类和实现了Comparable接口
5. BigDecimal 针对加减乘除提供可特定的方法，因为BigDecimal不支持( , -, *, /)数学运算
6. BigDecimal 的对象是不可变的
7. BigDecimal因为创建对象开销的原因，所以很多操作都是比原生类型要慢一些的。

作者：刘不二链接：https://juejin.cn/post/6918336976726786061

,