文章目录

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


前言:

使用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

toString()与科学计数法

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

首先,任何一个BigDecimal都可以使用一个公式表示:
unscaledValue × springboot科学计数法显示 tostring 科学计数_springboot科学计数法显示

解释一下:
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:

springboot科学计数法显示 tostring 科学计数_BigDecimal三种打印_02


源码中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()

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