java.math.BigDecimal类的中文翻译

原文：

java.math.BigDecimal类的中文翻译(一)

http://blog.sina.com.cn/s/blog_41532384010002td.html

java.math.BigDecimal类的中文翻译（二）

http://blog.sina.com.cn/s/blog_41532384010002te.html

 

类 java.math.BigDecimal

public class BigDecimal

extends Number

不可变的、任意精度的带符号的十进制数。 一个 BigDecimal 由一个任意精度的整数值和一个非负的整数标度组成，整数标度代表小数点右边的十进制数字的个数(用 BigDecimal 表示的数值大小是 intVal/10**scale)。 BigDecimals 提供基本的算术操作、精度处理、比较、格式转换和散列。

BigDecimal 类使它的用户对舍入行为有完全的控制权，迫使用户显式地指定能够舍弃部分精度( (除法 和 setScale))的舍入操作的舍入行为。为达到该目的，该类提供了八个 舍入模式 。同时针对 BigDecimal 的精度操作提供了两种类型的操作：数值调整/舍入 (scaling/rounding)操作和小数点移动操作。Scaling/Rounding 操作 (SetScale) 返回一个 BigDecimal，其数值近似 (或精确) 等于操作数，其有效范围是指定的值；也就是说，它们以对数值产生最小影响的方式增加或减少精度。十进制小数点移动操作 (movePointLeft 和 movePointRight)返回一个 BigDecimal ，它是把操作数的小数点在指定方向移动一个指定距离产生的；这种操作可以改变一个数字的值但不影响它的精度。

 

参见：

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 异常。

java.math.BigDecimal类的中文翻译（二）

 (2006-04-07 11:52:12)

转载▼

分类： Java技术

方法

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