BigDecimal 用法总结

系统管理员 2022-04-12 02:48 399阅读 0赞

Java 在 java.math 包中提供的 API 类 BigDecimal，用来对超过16位有效位的数进行精确的运算

提供以下操作：算术、标度操作、舍入、比较、哈希算法和格式转换。

用户能通过提供 MathContext 对象完全控制 BigDecimal 的舍入行为（也可使用类内提供的8种舍入模式）。如果未指定舍入模式，并且无法表示准确结果，则抛出一个异常。

### 1、构造方法 ###

BigDecimal 一般用如下4个构造方法:

<table> 
 <tbody> 
  <tr> 
   <td>方法名称</td> 
   <td>方法解释</td> 
  </tr> 
  <tr> 
   <td>BigDecimal(int)</td> 
   <td>创建一个具有参数所指定整数值的对象</td> 
  </tr> 
  <tr> 
   <td>BigDecimal(double)</td> 
   <td>创建一个具有参数所指定双精度值的对象。（不建议采用）</td> 
  </tr> 
  <tr> 
   <td>BigDecimal(long)</td> 
   <td>创建一个具有参数所指定长整数值的对象</td> 
  </tr> 
  <tr> 
   <td>BigDecimal(String)</td> 
   <td>创建一个具有参数所指定以字符串表示的数值的对象</td> 
  </tr> 
 </tbody> 
</table>

## ##

### 2、加减乘除运算 ###

<table> 
 <tbody> 
  <tr> 
   <td>方法名称</td> 
   <td>方法解释</td> 
  </tr> 
  <tr> 
   <td>public BigDecimal add(BigDecimal value)</td> 
   <td>加法</td> 
  </tr> 
  <tr> 
   <td>public BigDecimal subtract(BigDecimal value)</td> 
   <td>减法</td> 
  </tr> 
  <tr> 
   <td>public BigDecimal multiply(BigDecimal value)</td> 
   <td>乘法</td> 
  </tr> 
  <tr> 
   <td>public BigDecimal divide(BigDecimal value)</td> 
   <td>除法</td> 
  </tr> 
 </tbody> 
</table>

注意: divide 除法需要注意精度，因为存在除不开的情况，这时需要考虑保留位数和舍入模式，需要用到如下方法

public BigDecimal divide(BigDecimal divisor, int scale, int roundingMode) 第一参数表示除数， 第二个参数表示小数点后保留位数，第三个参数表示舍入模式，只有在作除法运算或四舍五入时才用到舍入模式

### 3、舍入模式 ###

<table> 
 <tbody> 
  <tr> 
   <td>枚举值</td> 
   <td>解释</td> 
   <td>原值</td> 
   <td>保留5位取值</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.UP</td> 
   <td>远离零的舍入模式（向上舍入）。舍弃某部分时，若舍弃部分非零则对其前面的数字加1（此舍入模式始终不会减少计算值的大小）</td> 
   <td>0.833333...</td> 
   <td>0.83334</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.DOWN</td> 
   <td>接近零的舍入模式（向下舍入）。直接丢弃需舍弃部分（此舍入模式始终不会增加计算值的大小）</td> 
   <td>0.833333...</td> 
   <td>0.83333</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.CEILING</td> 
   <td>接近正无穷大的舍入模式。若BigDecimal为正，则舍入行为同ROUND_UP；若为负，则舍入行为同ROUND_DOWN（此舍入模式始终不会减少计算值大小）</td> 
   <td>0.833333...</td> 
   <td>0.83334</td> 
  </tr> 
  <tr> 
   <td>-0.833333...</td> 
   <td>-0.83333</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.FLOOR</td> 
   <td>接近负无穷大（不是无穷小哦）的舍入模式。其行为与ROUND_CEILING相反，若BigDecimal为负，则舍入行为同ROUND_UP；若为正，则舍入行为同ROUND_DOWN（此舍入模式始终不会增加计算值大小）</td> 
   <td>0.833333...</td> 
   <td>0.83333</td> 
  </tr> 
  <tr> 
   <td>-0.833333...</td> 
   <td>-0.83334</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.HALF_UP</td> 
   <td>向最接近的”数字舍入，如果与两个相邻数字的距离相等，则为向上舍入的舍入模式（四舍五入，即舍弃部分&gt;=0.5则向上舍入，否则向下舍入）</td> 
   <td>0.9166666...</td> 
   <td>0.91667</td> 
  </tr> 
  <tr> 
   <td>0.833333...</td> 
   <td>0.83333</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.HALF_DOWN</td> 
   <td>向最接近的”数字舍入，如果与两个相邻数字的距离相等，则为向下舍入的舍入模式（舍弃部分&lt;=0.5则向下舍入，否则向上舍入）</td> 
   <td>0.9166666..</td> 
   <td>0.91667</td> 
  </tr> 
  <tr> 
   <td>0.833333...</td> 
   <td>0.83333</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.HALF_EVEN</td> 
   <td>向最接近的数字舍入，如果与两个相邻数字的距离相等，则向相邻的偶数舍入（在重复进行一系列计算时，此舍入模式可以将累加错误减到最小）</td> 
   <td>3.3333333...</td> 
   <td>3.33333</td> 
  </tr> 
  <tr> 
   <td>0.9166666...</td> 
   <td>0.91667</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.UNNECESSARY</td> 
   <td>断言请求的操作具有精确的结枚，因此不需要舍入，若该操作无精确结果（如1/3）则抛出&nbsp;ArithmeticException</td> 
   <td>1</td> 
   <td>1.00000</td> 
  </tr> 
  <tr> 
   <td>0.333333...</td> 
   <td>ArithmeticException</td> 
  </tr> 
 </tbody> 
</table>

java 的 math 包下 RoundingMode枚举类源码如下

public static RoundingMode valueOf(int rm) {
            switch(rm) {
    
            case BigDecimal.ROUND_UP:
                return UP;
    
            case BigDecimal.ROUND_DOWN:
                return DOWN;
    
            case BigDecimal.ROUND_CEILING:
                return CEILING;
    
            case BigDecimal.ROUND_FLOOR:
                return FLOOR;
    
            case BigDecimal.ROUND_HALF_UP:
                return HALF_UP;
    
            case BigDecimal.ROUND_HALF_DOWN:
                return HALF_DOWN;
    
            case BigDecimal.ROUND_HALF_EVEN:
                return HALF_EVEN;
    
            case BigDecimal.ROUND_UNNECESSARY:
                return UNNECESSARY;
    
            default:
                throw new IllegalArgumentException("argument out of range");
            }
        }

从中可以看出它们的对应关系，如、RoundingMode.UP 与 BigDecimal.ROUND\_UP 等价

<table> 
 <tbody> 
  <tr> 
   <td>枚举变量名</td> 
   <td>枚举变量名</td> 
   <td>常量值</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.UP</td> 
   <td>BigDecimal.ROUND_UP</td> 
   <td>0</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.DOWN</td> 
   <td>BigDecimal.ROUND_DOWN</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.CEILING</td> 
   <td>BigDecimal.ROUND_CEILING</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.FLOOR</td> 
   <td>BigDecimal.ROUND_FLOOR</td> 
   <td>3</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.HALF_UP</td> 
   <td>BigDecimal.ROUND_HALF_UP</td> 
   <td>4</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.HALF_DOWN</td> 
   <td>BigDecimal.ROUND_HALF_DOWN</td> 
   <td>5</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.HALF_EVEN</td> 
   <td>BigDecimal.ROUND_HALF_EVEN</td> 
   <td>6</td> 
  </tr> 
  <tr> 
   <td>RoundingMode.UNNECESSARY</td> 
   <td>BigDecimal.ROUND_UNNECESSARY</td> 
   <td>7</td> 
  </tr> 
 </tbody> 
</table>

### 4、其他 ###

BigDecimal 可以通过 setScale 方法设置精度及舍入方式

public BigDecimal setScale(int newScale, RoundingMode roundingMode) {
            return setScale(newScale, roundingMode.oldMode);
    }

### 5、参考 ###

官方文档     [https://docs.oracle.com/javase/6/docs/api/java/math/BigDecimal.html][https_docs.oracle.com_javase_6_docs_api_java_math_BigDecimal.html]

[https_docs.oracle.com_javase_6_docs_api_java_math_BigDecimal.html]: https://docs.oracle.com/javase/6/docs/api/java/math/BigDecimal.html