定义
BigDecimal 代表的值为:
u
n
s
c
a
l
e
d
V
a
l
u
e
×
1
0
−
s
c
a
l
e
unscaledValue × 10^{-scale}
unscaledValue×10−scale
BigDecimal 是一个不变的,任意精度的带符号的十进制数字
由任意精度整数未缩放值和32位整数级别组成 。 如果为零或正数,则刻度是小数点右侧的位数。 如果是负数,则数字的非标定值乘以10
- 关于四舍五入
BigDecimal类完全由开发者控制舍入。 如果未指定舍入模式,并且无法表示确切的结果,则抛出异常;
可以通过向操作提供适当的MathContext对象来进行计算,以选择精度和舍入模式。
在这两种情况下,都提供了八种舍入方式来控制舍入。使用RoundingMode 枚举(如RoundingMode.HALF_UP )的枚举值。
属性(成员变量)
static BigDecimal ONE
值为1,精度为0
static int ROUND_CEILING
接近正无穷大的舍入模式。
如果 BigDecimal 为正,则舍入行为与 ROUND_UP 相同;
如果为负,则舍入行为与 ROUND_DOWN 相同。
注意,此舍入模式始终不会减少计算值。
static int ROUND_DOWN
接近零的舍入模式。
在丢弃某部分之前始终不增加数字(从不对舍弃部分前面的数字加1,即截短)。
注意,此舍入模式始终不会增加计算值的大小。
static int ROUND_FLOOR
接近负无穷大的舍入模式。
如果 BigDecimal 为正,则舍入行为与 ROUND_DOWN 相同;
如果为负,则舍入行为与 ROUND_UP 相同。
注意,此舍入模式始终不会增加计算值。
static int ROUND_HALF_DOWN
向“最接近的”数字舍入,如果与两个相邻数字的距离相等,则为上舍入的舍入模式。
如果舍弃部分 > 0.5,则舍入行为与 ROUND_UP 相同;否则舍入行为与 ROUND_DOWN 相同(五舍六入)。
static int ROUND_HALF_EVEN
向“最接近的”数字舍入,如果与两个相邻数字的距离相等,则向相邻的偶数舍入。
如果舍弃部分左边的数字为奇数,则舍入行为与 ROUND_HALF_UP 相同;
如果为偶数,则舍入行为与 ROUND_HALF_DOWN 相同。
注意,在重复进行一系列计算时,此舍入模式可以将累加错误减到最小。
此舍入模式也称为“银行家舍入法”,主要在美国使用。四舍六入,五分两种情况。
如果前一位为奇数,则入位,否则舍去。
以下例子为保留小数点1位,那么这种舍入方式下的结果。
1.15>1.2 1.25>1.2
static int ROUND_HALF_UP
向“最接近的”数字舍入,如果与两个相邻数字的距离相等,则为向上舍入的舍入模式。
如果舍弃部分 >= 0.5,则舍入行为与 ROUND_UP 相同;否则舍入行为与 ROUND_DOWN 相同。
注意,这是我们大多数人在小学时就学过的舍入模式(四舍五入)。
static int ROUND_UNNECESSARY
断言请求的操作具有精确的结果,因此不需要舍入。
如果对获得精确结果的操作指定此舍入模式,则抛出ArithmeticException。
static int ROUND_UP
舍入远离零的舍入模式。
在丢弃非零部分之前始终增加数字(始终对非零舍弃部分前面的数字加1)。
注意,此舍入模式始终不会减少计算值的大小。
static BigDecimal TEN
值为10精度为0
static BigDecimal ZERO
值为0,精度为0
常用构造方法
BigDecimal(BigInteger val)
将 BigInteger转换成 BigDecimal 。
BigDecimal(BigInteger unscaledVal, int scale)
**将BigInteger的 BigInteger值和 int等级转换为 BigDecimal **
BigDecimal(BigInteger unscaledVal, int scale, MathContext mc)
将 BigInteger未缩放值和 int扩展转换为 BigDecimal ,根据上下文设置进行舍入。
BigDecimal(BigInteger val, MathContext mc)
根据上下文设置将 BigInteger转换为 BigDecimal舍入。
BigDecimal(double val)
将 double转换为 BigDecimal ,这是 double的二进制浮点值的精确十进制表示。
BigDecimal(double val, MathContext mc)
将 double转换为 BigDecimal ,根据上下文设置进行舍入。
BigDecimal(int val)
将 int成 BigDecimal 。
BigDecimal(int val, MathContext mc)
将 int转换为 BigDecimal ,根据上下文设置进行舍入。
BigDecimal(long val)
将 long成 BigDecimal 。
BigDecimal(long val, MathContext mc)
将 long转换为 BigDecimal ,根据上下文设置进行舍入。
BigDecimal(String val)
将BigDecimal的字符串表示 BigDecimal转换为 BigDecimal 。
BigDecimal(String val, MathContext mc)
一个转换的字符串表示 BigDecimal成 BigDecimal ,接受相同的字符串作为 BigDecimal(String)构造,利用根据上下文设置进行舍入。
常用方法
方法 | 返回值 | 示例 | 备注 |
---|---|---|---|
比较compareTo(BigDecimal val) | int | a.compareTo(b) | 结果为 -1,0或则1 |
除以divide(BigDecimal divisor) | BigDecimal | a.divide(b) | 获取指定默认精度的商 |
除以 divide(BigDecimal divisor, int scale, int roundingMode) | BigDecimal | a.divide(b,DECIMAL_SCALE,BigDecimal.ROUND_HALF_DOWN) | 获取指定指定精度的商 ,其他类似重载方法类似 |
获取double值doubleValue() | double | a.doublevalue() | float int long 用法类似 |
获取相等性equals(Object x) | boolean | a.equals(b) | 获取两个BigDecimal值相等性 |
小数点左移movePointLeft(int n) | BigDecimal | a.movePointLeft(1) | 右移类似 |
乘以multiply(BigDecimal multiplicand) | BigDecimal | a.multiply(b) | 相乘 |
乘以multiply(BigDecimal multiplicand, MathContext mc) | BigDecimal | a.multiply(b,BigDecimal.ROUND_HALF_DOWN) | 指定精度 |
取反negate() | BigDecimal | a.negate(b) | 获取该数的相反数 |
相减subtract(BigDecimal subtrahend) | a.subtract(b) | BigDecimal | a-b |
取模remainder(BigDecimal divisor) | BigDecimal | a.remainder(b) | a%b |
指定scalesetScale(int newScale) | BigDecimal | a.setScale(2) | 将a的小数部分位数设为2 |
shortValueExact() | short | a.shortValueExact() | 将此 BigDecimal转换为 short ,检查丢失的信息。 |
总结
BigDecimal类在实际开发中用的特别多,比如在价格,费率等需要精确计算的地方
这里只是列举了BigDecimal的部分用法
如果涉及到这里没有的用法,大家可以参考java的官方文档