Java常用类库之BigDecimal

BigDecimal

概念

运行0.1+0.2时，发现float和double的运算误差，由于float类型和douoble类型在运算时可能会有误差，需要使用java.math.BigDecimal类加以描述

常用构造方法

public BigDecimal(String val){

}

常用方法

add​(BigDecimal augend)

• 功能：返回 BigDecimal其值为 (this + augend)

BigDecimal b1 = new BigDecimal("0.1");
BigDecimal b2 = new BigDecimal("0.2");
BigDecimal b3 = b1.add(b2);
System.out.println(b3);
//0.3
//取出BigDecimal中的double
b3.doubleValue();
//MathContext指示小数长度
BigDecimal b3 = b1.add(b2, MathContext.DECIMAL32);

subtract​(BigDecimal subtrahend)

• 功能：返回 BigDecimal其值为 (this - subtrahend) ，其比例为 max(this.scale(), subtrahend.scale()) 。

divide​(BigDecimal divisor)

• 功能：返回BigDecimal其值为(this / divisor)

BigDecimal b1 = new BigDecimal("1.5");
BigDecimal b2 = new BigDecimal("3");
BigDecimal b3 = b1.divide(b2);
System.out.println(b3);
//0.5
//计算4/3时，因为输出是无限循环小数而报错

multiply​(BigDecimal multiplicand)

• 功能：返回 BigDecimal其值为 (this × multiplicand) ，其比例为 (this.scale() + multiplicand.scale()) 。

BigDecimal b1 = new BigDecimal("12.34");
BigDecimal b2 = new BigDecimal("11.11");
BigDecimal b3 = b1.multiply(b2, MathContext.DECIMAL32);
System.out.println(b3);
//137.0974

divide​(BigDecimal divisor, int scale, RoundingMode roundingMode)

• 功能：返回BigDecimal其值为(this / divisor)，同时控制器精度scale（小数点后几位），控制其s舍入模式roundingMode

BigDecimal b1 = new BigDecimal("4");
BigDecimal b2 = new BigDecimal("3");
BigDecimal b3 = b1.divide(b2, 3, RoundingMode.DOWN);
System.out.println(b3);
//1.33

• 其他除法操作
  • divideToIntegralValue​(BigDecimal divisor, MathContext mc),返回商的整数解
  • divideAndRemainder​(BigDecimal divisor, MathContext mc)，返回商和余数两个BigDecimal操作数

remainder​(BigDecimal divisor)

• 功能：求余，注意与模运算不同。当 x 和 y 的正负号一样的时候，两个函数结果是等同的；当 x 和 y 的符号不同时，rem 函数结果的符号和 x 的一样，而 mod 和 y 一样。

• 这是由于这两个函数的生成机制不同，rem 函数采用 fix 函数（向 0 方向舍入），而 mod 函数采用了 floor 函数（向无穷小方向舍入)

  • rem(x，y) 返回的是 x-n*y，如果 y 不等于 0，n = fix(x./y)
  • mod(x, y) 返回的是 x-n*y，如果 y 不等于 0，n = floor(x./y)

参考来源：https://www.runoob.com/w3cnote/remainder-and-the-modulo.html

BigDecimal b1 = new BigDecimal("-5.2");
BigDecimal b2 = new BigDecimal("2");
BigDecimal b3 = b1.remainder(b2);
System.out.println(b3);
//fix(-5.2/2) = -2; 5.2-(-2)*2 = -1.2

pow​(int n, MathContext mc)

• 功能：返回 BigDecimal其值为 (this^n)

BigDecimal b1 = new BigDecimal("12.34");
BigDecimal b2 = new BigDecimal("11.11");
BigDecimal b3 = b1.pow(8, MathContext.DECIMAL32);
System.out.println(b3);
//5.376768E+8

negate​()

• 功能：返回 BigDecimal其值为 (-this) ，根据上下文设置（MathContext）进行舍入。
• plus(),返回+this

round​(MathContext mc)

• 功能：四舍五入，MathContext设置保留位数

public int compareTo​(BigDecimal val)

• 功能：比较两个BigDecimal的大小

BigDecimal b1 = new BigDecimal("3");
BigDecimal b2 = new BigDecimal("3");
int b3 = b1.compareTo(b2);
System.out.println(b3);
//3,3 -> 0
//2,3 -> -1
//4,3 -> 1

public boolean equals​(Object x)

• 功能：将此BigDecimal与指定的Object进行相等性比较。 与compareTo不同，此方法仅考虑两个BigDecimal对象的值和比例相等（因此通过此方法比较时2.0不等于2.00）。

BigDecimal b1 = new BigDecimal("3");
BigDecimal b2 = new BigDecimal("3.00");
System.out.println(b1.equals(b2));
//false

public BigDecimal max​(BigDecimal val)

• 功能：比较并返回最大值

BigDecimal b1 = new BigDecimal("3.5");
BigDecimal b2 = new BigDecimal("3");
BigDecimal b3 = b1.max(b2);
System.out.println(b3);
//3.5
//BigDecimal b3 = b1.min(b2);

public static BigDecimal valueOf​(double val)

• 功能：转换一个 double成 BigDecimal ，使用 double通过所提供的规范的字符串表示 Double.toString(double)方法

double val = 1.2222;
BigDecimal b1 = BigDecimal.valueOf(val);
System.out.println(b1);

public double doubleValue()

• 功能：将BigDecimal转换为double。

public BigDecimal movePointLeft​(int n)

• 功能：向左移动n位小数点

BigDecimal b1 = new BigDecimal("3.5");
BigDecimal b3 = b1.movePointLeft(8);
System.out.println(b3);
//3.5E-8
//BigDecimal b3 = b1.movePointLeft(8);

precision()

• 功能：求精度

BigDecimal b1 = new BigDecimal("12.346");
System.out.println(b1.precision());

int scale()

• 功能：返回小数点后的位数

BigDecimal b1 = new BigDecimal("-5.22323");
System.out.println(b1.scale());
//5

scaleByPowerOfTen​(int n)

• 功能：乘10^n次幂

BigDecimal b1 = new BigDecimal("-5.22323");
BigDecimal b3 = b1.scaleByPowerOfTen(2);
System.out.println(b3);
//-522.323

setScale​(int newScale, RoundingMode roundingMode)

• 功能：设置小数点后位数

BigDecimal b1 = new BigDecimal("-5.22323");
BigDecimal b3 = b1.setScale(2, RoundingMode.DOWN);
System.out.println(b3);
//-5.22

stripTrailingZeros()

• 功能：减去尾随的多余的0

BigDecimal b1 = new BigDecimal("-522000");
BigDecimal b2 = new BigDecimal("2.00");
BigDecimal b3 = b1.stripTrailingZeros();
BigDecimal b4 = b2.stripTrailingZeros();
System.out.println(b3);
//-5.22E5
System.out.println(b4);
//2

public BigDecimal ulp()

• 功能：返回此BigDecimal的ulp（最后一个单位）的BigDecimal 。 非零BigDecimal值的ulp是该值与BigDecimal值之间的正距离，该值接着在数量上具有相同的位数。 零值的ulp在数值上等于1，比例为this 。 结果以与this相同的比例存储，因此零和非零值的结果等于[1, this.scale()] 。

BigDecimal b1 = new BigDecimal("-12.324");
BigDecimal b2 = new BigDecimal("212120");
BigDecimal b3 = b1.ulp();
BigDecimal b4 = b2.ulp();
System.out.println(b3);
//0.001
System.out.println(b4);
//1
//"0" -> 1
//整数都是1

MathContext字段

MathContext字段	有效数字
DECIMAL32	7位
DECIMAL64	16位
DECIMAL128	34位
UNLIMITED	无限

RoundingMode

UP DOWN CEILING FLOOR HALF_UP HALF_DOWN HALF_EVEN UNNECESSARY