不可变的、任意精度的带符号的十进制数。 一个 BigDecimal
由一个任意精度的整数值和一个非负的整数标度组成,整数标度代表小数点右边的十进制数字的个数(用 BigDecimal 表示的数值大小是
intVal/10**scale)。 BigDecimals 提供基本的算术操作、精度处理、比较、格式转换和散列。
BigDecimal 类使它的用户对舍入行为有完全的控制权,迫使用户显式地指定能够舍弃部分精度(
(除法 和 setScale))的舍入操作的舍入行为。为达到该目的,该类提供了八个
舍入模式 。同时针对
BigDecimal 的精度操作提供了两种类型的操作:数值调整/舍入
(scaling/rounding)操作和小数点移动操作。Scaling/Rounding 操作 (SetScale) 返回一个 BigDecimal,其数值近似 (或精确) 等于操作数,其有效范围是指定的值;也就是说,它们以对数值产生最小影响的方式增加或减少精度。十进制小数点移动操作 (movePointLeft 和 movePointRight)返回一个 BigDecimal ,它是把操作数的小数点在指定方向移动一个指定距离产生的;这种操作可以改变一个数字的值但不影响它的精度。
类 java.math.BigDecimal
java.lang.Object
|
+----java.lang.Number
|
+----java.math.BigDecimal
- public class BigDecimal
- extends Number
- 参见:
- BigInteger
变量索引
- ROUND_CEILING
- 如果 BigDecimal 是正的,则做 ROUND_UP 操作;如果为负,则做 ROUND_DOWN 操作。
- ROUND_DOWN
- 从不在舍弃(即截断)的小数之前增加数字。
- ROUND_FLOOR
- 如果 BigDecimal 为正,则作 ROUND_UP ;如果为负,则作 ROUND_DOWN 。
- ROUND_HALF_DOWN
- 若舍弃部分> .5,则作 ROUND_UP;否则,作 ROUND_DOWN 。
- ROUND_HALF_EVEN
- 如果舍弃部分左边的数字为奇数,则作 ROUND_HALF_UP ;如果它为偶数,则作 ROUND_HALF_DOWN 。
- ROUND_HALF_UP
- 若舍弃部分>=.5,则作 ROUND_UP ;否则,作 ROUND_DOWN 。
- ROUND_UNNECESSARY
- 该“伪舍入模式”实际是指明所要求的操作必须是精确的,,因此不需要舍入操作。
- ROUND_UP
- 总是在非 0 舍弃小数(即截断)之前增加数字。
构造子索引
- BigDecimal(BigInteger)
- 把一个 BigInteger 翻译成 BigDecimal 。
- BigDecimal(BigInteger, int)
- 把一个 BigInteger 和一个标度翻译成 BigDecimal 。
- BigDecimal(double)
- 把一个 double 型翻译成 BigDecimal 。
- BigDecimal(String)
- 从一个字符串构造 BigDecimal ,该字符串包含一个可选的减号,后面跟着一串零或十进制数字串,再后面是一个可选的小数部分,该小数部分包含一个小数点和一串零或十进制数字串。
方法索引
- abs()
- 返回一个 BigDecimal ,其值是该数的绝对值,其标度是 this.scale() 。
- add(BigDecimal)
- 返回一个 BigDecimal ,其值是 (this + val),其标度是 MAX(this.scale(),val.scale) 。
- compareTo(BigDecimal)
- 返回 -1、0 或 1,分别表示该数是小于、等于、或大于 val 。
- divide(BigDecimal, int)
- 返回一个 BigDecimal ,其值是 (this/val),其标度是 this.scale() 。
- divide(BigDecimal, int, int)
- 返回一个 BigDecimal ,其值是 (this / val),其标度是指定值 。
- doubleValue()
- 把一个数字转换为 double 型。
- equals(Object)
- 如果 x 是一个等于该数字的 BigDecimal ,则返回 true。
- floatValue()
- 把该数字转换为 float 型。
- hashCode()
- 计算该对象的散列码。
- intValue()
- 把该数字转换为 int 值。
- longValue()
- 把该数字转换为 long 型。
- max(BigDecimal)
- 返回 BigDecimal ,其值是 this 和 val 中的较大者。
- min(BigDecimal)
- 返回 BigDecimal ,其值是 this 和 val 中的较小者。
- movePointLeft(int)
- 返回一个 BigDecimal ,其值等于该数十进制小数点向左移动
n 位后所得的值。
- movePointRight(int)
- 把十进制小数点按指定数值向右移动相应位数。
- multiply(BigDecimal)
- 返回一个 BigDecimal ,其值是 (this * val),其标度是 this.scale() + val.scale 。
- negate()
- 返回一个 BigDecimal ,其值是 -1 * val ,其标度是 this.scale() 。
- scale()
- 返回该数值的标度。
- setScale(int)
- 返回一个 BigDecimal ,其标度是指定值,其数值精确等于该数字的值。
- setScale(int, int)
- 返回一个 BigDecimal ,其标度是指定值,其整数值是该 BigDecimal 的整数部分被 10 的适当次幂(保持整个数值不变)乘或者除得到。
- signum()
- 返回该数值的符号(即根据该数的值是正、零或负返回 -1 、
0 或 1 )。
- subtract(BigDecimal)
- 返回一个 BigDecimal ,其值是 (this - val),其标度是 MAX(this.scale(),val.scale) 。
- toBigInteger()
- 把该数字转换为 BigInteger 。
- toString()
- 返回表示该数字的字符串。
- valueOf(long)
- 按照给定的值和零标度返回一个 BigDecimal 。
- valueOf(long, int)
- 返回一个 BigDecimal ,其值是 (val/10**scale)。
变量
ROUND_UP
public static final int ROUND_UP
- 总是在非零的舍弃小数(即截断)之前增加数字。
注意该舍入模式不减少量值。
(从零开始舍入)
ROUND_DOWN
public static final int ROUND_DOWN
- 从不在舍弃的小数(即截断)之前增加数字。 注意该舍入模式不增加量值。 (舍入到零)
ROUND_CEILING
public static final int ROUND_CEILING
- 如果 BigDecimal 为正,则作 ROUND_UP 操作;如果为负,则作 ROUND_DOWN 操作。注意该舍入模式不减少值。(舍入到正无穷大)
ROUND_FLOOR
public static final int ROUND_FLOOR
- 如果 BigDecimal 为正,则作 ROUND_UP ;如果为负,则作 ROUND_DOWN 。注意该舍入模式不增加值。(舍入到负无穷大)
ROUND_HALF_UP
public static final int ROUND_HALF_UP
- 若舍弃部分>=.5,则作 ROUND_UP ;否则,则作 ROUND_DOWN (舍入到 “最近的数值”,除非向上舍入和向下舍入的距离是相等的)。
ROUND_HALF_DOWN
public static final int ROUND_HALF_DOWN
- 若舍弃部分> .5 ,则作 ROUND_DOWN;否则,作 ROUND_DOWN 操作(舍入到 “最近的数值”,除非向下舍入和向上舍入的距离相等)。
ROUND_HALF_EVEN
public static final int ROUND_HALF_EVEN
- 如果舍弃部分左边的数字为奇数,则作 ROUND_HALF_UP 操作;如果它为偶数,则作 ROUND_HALF_DOWN 操作(舍入到 “最近的数值”,除非向到两边的距离相等)。
ROUND_UNNECESSARY
public static final int ROUND_UNNECESSARY
- 该 “伪舍入模式”实际是要求操作有一个精确结果,,因此不需要舍入。如果该舍入模式对一个指定的操作产生不精确的结果,则抛出算术异常。
构造子
BigDecimal
public BigDecimal(String val) throws NumberFormatException
- 从一个字符串构造 BigDecimal ,该字符串包含可选的减号,后面跟着一串零或十进制数字序列,再后面可能会跟着一个小数部分,该小数部分由一个小数点和一串零或一个十进制数字序列构成。字符串必须至少包含一个整数部分或一个小数部分。作为结果的 BigDecimal 标度将是字符串中十进制小数点右边的数字,如果字符串中未包含十进制小数点则为零。字符到数字的映射是由 Character.digit 提供的。
任何外部字符 (包括空白符) 将导致一个 NumberFormatException 异常。
BigDecimal
public BigDecimal(double val) throws NumberFormatException
- 把一个 double 型翻译成 BigDecimal 。BigDecimal
的标度是使 10**scale * val 为一整数的最小数值。
一个 double 值,若为负无穷、正无穷或 NaN 将导致一个
NumberFormatException 异常。
BigDecimal
public BigDecimal(BigInteger val)
- 把一个 BigInteger 翻译成 BigDecimal 。 BigDecimal
的标度为零。
BigDecimal
public BigDecimal(BigInteger val,int scale)
throws NumberFormatException
- 把一个 BigInteger 和一个标度翻译成一个 BigDecimal 。
BigDecimal 的值是 (BigInteger/10**scale) 。 负标度将导致一个
NumberFormatException 异常。
方法
valueOf
public static BigDecimal valueOf(long val, int scale)
throws NumberFormatException
- 返回一个 BigDecimal ,其值是 (val/10**scale) 。 该函数首选使用 (long) 构造子,因为它允许对 BigDecimals (如 0 和 1)的频繁使用进行重用,从而消除了输出常数时的这种需要。
一个负标度将导致
NumberFormatException 异常。
valueOf
public static BigDecimal valueOf(long val)
- 用给定的值和零标度构造并返回一个 BigDecimal 。该函数首选使用 (long) 构造子,因为它允许对 BigDecimals (如 0 和 1)的频繁使用进行重用,从而消除了输出常数时的这种需要。
add
public BigDecimal add(BigDecimal val)
- 返回一个 BigDecimal ,其值是 (this + val),其标度是 MAX(this.scale(),val.scale) 。
subtract
public BigDecimal subtract(BigDecimal val)
- 返回一个 BigDecimal ,其值是 (this - val),其标度是 MAX(this.scale(),val.scale) 。
multiply
public BigDecimal multiply(BigDecimal val)
- 返回一个 BigDecimal ,其值是 (this * val),其标度是 this.scale() + val.scale 。
divide
public BigDecimal divide(BigDecimal val,int scale,int roundingMode)
throws ArithmeticException, IllegalArgumentException
- 返回一个 BigDecimal ,其值是 (this / val),其标度是指定值。如果必须执行舍入对给定的标度生成一个结果,则使用指定的舍入模式。如果 val == 0 ,scale <0 ,或舍入模式是 round_un necessary 并且指定的标度不足以表示除法结果的精确度时,抛出 arithmeticexception 异常;如果 roundingmode 不是有效的舍入模式,则抛出 illegalargumentexception 异常。
divide
public BigDecimal divide(BigDecimal val, int roundingMode)
throws ArithmeticException, IllegalArgumentException
- 返回一个 BigDecimal ,其值是 (this/val),其标度是 this.scale() 。 如果必须执行舍入对给定的标度生成一个结果,则将使用指定的舍入模式。 如果 val == 0 ,则抛出
ArithmeticException 异常。 如果 roundingMode 不是有效的舍入模式,则抛出 IlegalArgumentException 异常。
abs
public BigDecimal abs()
- 返回一个 BigDecimal ,其值是该数字的绝对值,其标度是 this.scale() 。
negate
public BigDecimal negate()
- 返回一个 BigDecimal ,其值是 -1 * val ,其标度是 this.scale()。
signum
public int signum()
- 返回该数值的符号 (根据该数的值是正、零或负返回 -1 、 0 或 1 )。
scale
public int scale()
- 返回该数字的标度。
setScale
public BigDecimal setScale(int scale,int roundingMode)
throws ArithmeticException, IllegalArgumentException
- 返回一个 BigDecimal ,其标度是指定值,其整数值是 BigDecimal 整数部分被 10 的适当次幂(保持整个数值不变)除或乘得到的。如果标度被操作减小,则必须除整数部分
(而不是乘),这可能丢失精度;这种情况下,除法将使用指定的舍入模式。
如果标度为负,或者舍入模式是 ROUND_UNNECESSARY 并且它不能执行不丢失精度的调整标度的操作时抛出 ArithmeticException ;如果 roundingMode
不是有效的舍入模式,则抛出 IlegalArgumentException。
setScale
public BigDecimal setScale(int scale)
throws ArithmeticException, IllegalArgumentException
- 返回一个 BigDecimal ,其标度是指定值,其值精确等于该数字的值。如果不可能做到则抛出 ArithmeticException 异常。该调用的典型应用是用来增加标度,它确保有一个指定标度和正确数值的
BigDecimal 。 这个调用也可被用来减少标度,如果调用者知道那个数字的小数结尾部分有足够多的零 (比如它的整数部分的十倍数因子),那么就可重新标度而不丢失精度。注意该调用返回的结果同使用两参数版本的
setScale 相同,这样就避免了调用者指定舍入模式这样的麻烦,因为在那种情况下指定舍入模式是不相关的。
movePointLeft
public BigDecimal movePointLeft(int n)
- 返回一个 BigDecimal ,它于该数十进制小数点向左移动
n 位后所得的值。若 n 非负,该调用仅把标度增加
n 。若 n 是负的,则该调用等价于调用
movePointRight(-n) ( 该调用返回的 BigDecimal 值是
(this * 10**-n) 并且标度是 MAX(this.scale()+n, 0))。
movePointRight
public BigDecimal movePointRight(int n)
- 把小数点按指定数值向右移动相应位数。
如果该数的标度 >= n,该调用只从标度减去 n ;否则它把标度设为零,并且乘以整数值
10 ** (n - this.scale) 。如果 n 是负的,则该调用等价于
movePointLeft(-n)(该调用返回的 BigDecimal 值是
(this * 10**n) 并且标度是 MAX(this.scale()-n, 0))。
compareTo
public int compareTo(BigDecimal val)
- 按照该数值是小于、等于或大于 val分别返回 -1、0 或 1 。两个 BigDecimals 在数值上相同但有不同的标度
(例如 2.0, 2.00)时,该方法认为它们是相等的。
该方法首选使用所提供的六个逻辑比较运算符
(<, ="=,">, >=, !=, <=)。执行这些比较的惯用方法是: (x.compareto(y) 0),其中 是六个比较符中的一个。
equals
public boolean equals(Object x)
- 如果 x 等于该数值,则返回 true 。
提供该方法的目的是使 BigDecimals 能被用做散列码关键字。
不同于 compareTo ,当且仅当两个 BigDecimals 的值和标度都相同时,该方法才认为它们两个相等。
- 覆盖:
- 类 Object 中的
equals
min
public BigDecimal min(BigDecimal val)
- 返回 BigDecimal ,其值是 this 和 val 中的较小者。
若值相等(根据 compareTo 运算符定义) ,则两者都有可能被返回。
max
public BigDecimal max(BigDecimal val)
- 返回 BigDecimal ,其值是 this 和 val 中的较大者。
若值相等(根据 compareTo 运算符定义) ,则两者都有可能被返回。
hashCode
public int hashCode()
- 为该对象计算一个散列码。两个 BigDecimals 在数值上相同但有不同的标度
(例如 2.0,2.00)时不会产生相同的散列码。
- 覆盖:
- 类 Object 中的 hashCode
toString
public String toString()
- 返回该数值的字符串表示(将使用由
Character.forDigit 提供的数字到字符的映射)。
减号和十进制小数点被用于指示符号和标度( 该表示法和(String, int)构造子是兼容的)。
- 覆盖:
- 类 Object 中的 toString
toBigInteger
public BigInteger toBigInteger()
- 把该数字转换为 BigInteger 。标准的限制原语转换同《Java 语言规范》一样。 特别要注意的是,该数字的任何小数部分将被截断。
intValue
public int intValue()
- 把该数字转换为一个 int 值。 标准的限制原语转换同
《Java 语言规范》一样。 特别要注意的是,该数字的任何小数部分将被截断。
- 覆盖:
- 类 Number 中的
intValue
longValue
public long longValue()
- 把该数字转换为一个 long 型值。 标准的限制原语转换同
《Java 语言规范》一样。 特别要注意的是,该数字的任何小数部分将被截断。
- 覆盖:
- 类 Number 中的
longValue
floatValue
public float floatValue()
- 把该数字转换为 float 型。 类似于《Java 语言规范》中定义的 double-to-float
限制原语转换:如果数值太大以致不能表示为浮点数时,则将它适当地转换为无穷大或负无穷大。
- 覆盖:
- 类
Number 中的
floatValue
doubleValue
public double doubleValue()
- 把该数字转换为 double 型。 类似于《Java 语言规范》中定义的
double-to-float 限制原语转换:如果数值太大以致不能表示为双精度数时,则将它适当转换为无穷大或负无穷大。
- 覆盖:
- 类
Number 中的
doubleValue