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

叁歲伎倆 2023-10-05 22:40 11阅读 0赞

#### 文章目录 ####

*   *  前言：
     *  方法及含义
     *  toString()与科学计数法
     *  toEngineeringString()与工程计数法
     *  toPlainString()

### 前言： ###

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

### 方法及含义 ###

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

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

<table> 
 <thead> 
  <tr> 
   <th>打印值</th> 
   <th>不使用指数-toPlainString()</th> 
   <th>科学记数法-toString()</th> 
   <th>工程记数法-toEngineeringString()</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>0.0001</td> 
   <td>0.0001</td> 
   <td>0.0001</td> 
   <td>0.0001</td> 
  </tr> 
  <tr> 
   <td>0.0000001</td> 
   <td>0.0000001</td> 
   <td>1E-7</td> 
   <td>100E-9</td> 
  </tr> 
 </tbody> 
</table>

`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

### toString()与科学计数法 ###

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

首先，任何一个BigDecimal都可以使用一个公式表示：  
**unscaledValue ×  1 0 − s c a l e 10^\{-scale\} 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：  
![在这里插入图片描述][733e8ba918d14db7b58a518afd9059c3.png]  
源码中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
     }

### toEngineeringString()与工程计数法 ###

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

### toPlainString() ###

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

[733e8ba918d14db7b58a518afd9059c3.png]: https://img-blog.csdnimg.cn/733e8ba918d14db7b58a518afd9059c3.png