BigDecimal的toString()、toPlainString()和toEngineeringString()区别及用法

一、前言：

使用BigDecimal进行打印的时候，经常会对BigDecimal提供的三个toString方法感到好奇，以下整理3个toString方法的区别及用法。

二、方法及含义

以下内容介绍java.math.BigDecimal下的三个toString方法的区别及用法

• toPlainString() : 不使用任何指数。
• toString() ：有必要时使用科学计数法。
• toEngineeringString()：有必要时使用工程计数法。 工程记数法是一种工程计算中经常使用的记录数字的方法，与科学技术法类似，但要求10的幂必须是3的倍数

打印值	不使用指数-toPlainString()	科学记数法-toString()	工程记数法-toEngineeringString()
0.0001	0.0001	0.0001	0.0001
0.0000001	0.0000001	1E-7	100E-9

toString()、toEngineeringString()方法在某些时候会使用科学计数法或工程计数法，不是所有情况都会使用科学计数法或工程计数法的

对于一个数值可能很小的BigDecimal对象来说，使用toString()可能由于打印的数值太小而打印其科学计数法表示，而使用toPlainString()才能打印完整的数值。

import java.math.BigDecimal;

public class Test {
    public static void main(String[] args) {
        BigDecimal bg = new BigDecimal("1E11");
        System.out.println(bg.toString()); // 1E+11
        System.out.println(bg.toPlainString()); // 100000000000
        System.out.println(bg.toEngineeringString()); // 100E+9 
    }
}

执行结果

1E+11
100000000000
100E+9

2.1、toString()与科学计数法

toString方法会将BigDecimal的值以科学计数方式的字符串，但是转换成科学计数的方式也是有场景的，并不是所有的值都会转为科学计数方式的字符串。

首先，任何一个BigDecimal都可以使用一个公式表示：
unscaledValue × $10^{-scale}$

解释一下：
unscaledValue ：整数非标度值 （即去掉小数点的Bigdecimal的值，类型为BigInteger）
scale：标度值，如果为零或正数，则标度是小数点后的位数。如果为负数，则将该数的非标度值乘以 10 的负 scale 次幂。
如下，BigDecimal值为123.00，则unscaledValue 为12300，而scale为2，套用公式，则数值是相等的。

public static void main(String[] args){
   BigDecimal b = new BigDecimal("123.00");
   System.out.println(b.scale());
   System.out.println(b.unscaledValue());
}

执行结果：

2
12300

我们看一下源码中toString方法中给的example：

源码中toString方法上有很长的注释，主要介绍指数计算转换过程，简要总结了两种toString（）方法会以科学计数方式输出的场景：
场景一：scale为负数，一定会转换为科学计数的方式

public static void main(String[] args) {
    BigDecimal a = new BigDecimal("2340").setScale(-1);
    System.out.println(a.toString());
    System.out.println(a.toPlainString());
    System.out.println(a.scale());
    System.out.println(a.unscaledValue());
}
//执行结果
2.34E+3
2340
-1
234

场景二：
需要先计算变动指数的值。公式为-scale+(unscaleValue.length-1) ,如果该值小于-6，那么则会使用科学计数的方式输出字符串

public static void main(String[] args) {
    //案例一
     BigDecimal b1 = new BigDecimal("0.000000123").setScale(9);
     System.out.println(b1.toString());
     System.out.println(b1.toPlainString());
     System.out.println(b1.scale());
     System.out.println(b1.unscaledValue());
	//输出结果为
     1.23E-7
     0.000000123
     9
     123

	//案例二
     BigDecimal b2 = new BigDecimal("0.000001234").setScale(9);
     System.out.println(b2.toString());
     System.out.println(b2.toPlainString());
     System.out.println(b2.scale());
     System.out.println(b2.unscaledValue());
	//输出结果为
     0.000001234
     0.000001234
     9
     1234

	//案例三
     BigDecimal b3 = new BigDecimal("0.123000000").setScale(9);
     System.out.println(b3.toString());
     System.out.println(b3.toPlainString());
     System.out.println(b3.scale());
     System.out.println(b3.unscaledValue());
	//输出结果为
     0.123000000
     0.123000000
     9
     123000000

	 //案例四
     BigDecimal b4 = new BigDecimal("123000000");
     System.out.println(b4.toString());
     System.out.println(b4.toPlainString());
     System.out.println(b4.scale());
     System.out.println(b4.unscaledValue());
	//输出结果为
     123000000
     123000000
     0
     123000000

	//案例五
	//Double d = 12345678d; Double d = 12345678.0; 效果一样
     Double d = (double) 12345678;
     BigDecimal b5 = BigDecimal.valueOf(d);
     System.out.println(d);
     System.out.println(b5.toString());
     System.out.println(b5.toPlainString());
     System.out.println(b5.scale());
     System.out.println(b5.unscaledValue());
	//输出结果为
     1.2345678E7
     12345678
     12345678
     0
     12345678
 }

2.2、toEngineeringString()与工程计数法

Returns a string representation of this {@code BigDecimal}, using engineering notation if an exponent is needed. 返回此{@code BigDecimal}的字符串表示形式，如果需要指数，则使用工程符号（即如果一个BigDecimal类型的参数toString()是以指数形式返回，那么调用toEngineeringString()则以工程计数法返回，工程计数法返回的10的幂必须是3的倍数）

2.3、toPlainString()

不使用任何指数，原值输出为字符串

创作不易，欢迎打赏，你的鼓励将是我创作的最大动力。