BigDecimal的四舍五入的RoundingMode 选择

忘是亡心i 2023-07-04 12:55 20阅读 0赞

# BigDecimal的四舍五入的RoundingMode 选择 #

RoundingMode介绍：

`RoundingMode`是一个枚举类，有一下几个常量：UP，DOWN，CEILING，FLOOR，HALF\_UP，HALF\_DOWN，HALF\_EVEN，UNNECESSARY

--------------------

public static final RoundingMode UP

远离零方向舍入的舍入模式。始终对非零舍弃部分前面的数字加 1。注意，此舍入模式始终不会减少计算值的绝对值。

示例：

<table> 
 <tbody> 
  <tr> 
   <th>输入数字</th> 
   <th>使用&nbsp;UP&nbsp;舍入模式<br> 将输入数字舍入为一位数</th> 
  </tr> 
  <tr> 
   <td>5.5</td> 
   <td>6</td> 
  </tr> 
  <tr> 
   <td>2.5</td> 
   <td>3</td> 
  </tr> 
  <tr> 
   <td>1.6</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>1.1</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>1.0</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>-1.0</td> 
   <td>-1</td> 
  </tr> 
  <tr> 
   <td>-1.1</td> 
   <td>-2</td> 
  </tr> 
  <tr> 
   <td>-1.6</td> 
   <td>-2</td> 
  </tr> 
  <tr> 
   <td>-2.5</td> 
   <td>-3</td> 
  </tr> 
  <tr> 
   <td>-5.5</td> 
   <td>-6</td> 
  </tr> 
 </tbody> 
</table>

DOWN

public static final RoundingMode DOWN

向零方向舍入的舍入模式。从不对舍弃部分前面的数字加 1（即截尾）。注意，此舍入模式始终不会增加计算值的绝对值。

示例：

<table> 
 <tbody> 
  <tr> 
   <th>输入数字</th> 
   <th>使用&nbsp;DOWN&nbsp;舍入模式<br> 将输入数字舍入为一位数</th> 
  </tr> 
  <tr> 
   <td>5.5</td> 
   <td>5</td> 
  </tr> 
  <tr> 
   <td>2.5</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>1.6</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>1.1</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>1.0</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>-1.0</td> 
   <td>-1</td> 
  </tr> 
  <tr> 
   <td>-1.1</td> 
   <td>-1</td> 
  </tr> 
  <tr> 
   <td>-1.6</td> 
   <td>-1</td> 
  </tr> 
  <tr> 
   <td>-2.5</td> 
   <td>-2</td> 
  </tr> 
  <tr> 
   <td>-5.5</td> 
   <td>-5</td> 
  </tr> 
 </tbody> 
</table>

CEILING

public static final RoundingMode CEILING

向正无限大方向舍入的舍入模式。如果结果为正，则舍入行为类似于 RoundingMode.UP；如果结果为负，则舍入行为类似于 RoundingMode.DOWN。注意，此舍入模式始终不会减少计算值。

示例：

<table> 
 <tbody> 
  <tr> 
   <th>输入数字</th> 
   <th>使用&nbsp;CEILING&nbsp;舍入模式<br> 将输入数字舍入为一位数</th> 
  </tr> 
  <tr> 
   <td>5.5</td> 
   <td>6</td> 
  </tr> 
  <tr> 
   <td>2.5</td> 
   <td>3</td> 
  </tr> 
  <tr> 
   <td>1.6</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>1.1</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>1.0</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>-1.0</td> 
   <td>-1</td> 
  </tr> 
  <tr> 
   <td>-1.1</td> 
   <td>-1</td> 
  </tr> 
  <tr> 
   <td>-1.6</td> 
   <td>-1</td> 
  </tr> 
  <tr> 
   <td>-2.5</td> 
   <td>-2</td> 
  </tr> 
  <tr> 
   <td>-5.5</td> 
   <td>-5</td> 
  </tr> 
 </tbody> 
</table>

FLOOR

public static final RoundingMode FLOOR

向负无限大方向舍入的舍入模式。如果结果为正，则舍入行为类似于 RoundingMode.DOWN；如果结果为负，则舍入行为类似于RoundingMode.UP。注意，此舍入模式始终不会增加计算值。

示例：

<table> 
 <tbody> 
  <tr> 
   <th>输入数字</th> 
   <th>使用&nbsp;FLOOR&nbsp;舍入模式<br> 将输入数字舍入为一位数</th> 
  </tr> 
  <tr> 
   <td>5.5</td> 
   <td>5</td> 
  </tr> 
  <tr> 
   <td>2.5</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>1.6</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>1.1</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>1.0</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>-1.0</td> 
   <td>-1</td> 
  </tr> 
  <tr> 
   <td>-1.1</td> 
   <td>-2</td> 
  </tr> 
  <tr> 
   <td>-1.6</td> 
   <td>-2</td> 
  </tr> 
  <tr> 
   <td>-2.5</td> 
   <td>-3</td> 
  </tr> 
  <tr> 
   <td>-5.5</td> 
   <td>-6</td> 
  </tr> 
 </tbody> 
</table>

HALF\_UP

public static final RoundingMode HALF_UP

向最接近数字方向舍入的舍入模式，如果与两个相邻数字的距离相等，则向上舍入。如果被舍弃部分 >= 0.5，则舍入行为同 RoundingMode.UP；否则舍入行为同RoundingMode.DOWN。注意，此舍入模式就是通常学校里讲的四舍五入。

示例：

<table> 
 <tbody> 
  <tr> 
   <th>输入数字</th> 
   <th>使用&nbsp;HALF_UP&nbsp;舍入模式<br> 将输入数字舍入为一位数</th> 
  </tr> 
  <tr> 
   <td>5.5</td> 
   <td>6</td> 
  </tr> 
  <tr> 
   <td>2.5</td> 
   <td>3</td> 
  </tr> 
  <tr> 
   <td>1.6</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>1.1</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>1.0</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>-1.0</td> 
   <td>-1</td> 
  </tr> 
  <tr> 
   <td>-1.1</td> 
   <td>-1</td> 
  </tr> 
  <tr> 
   <td>-1.6</td> 
   <td>-2</td> 
  </tr> 
  <tr> 
   <td>-2.5</td> 
   <td>-3</td> 
  </tr> 
  <tr> 
   <td>-5.5</td> 
   <td>-6</td> 
  </tr> 
 </tbody> 
</table>

HALF\_DOWN

public static final RoundingMode HALF_DOWN

向最接近数字方向舍入的舍入模式，如果与两个相邻数字的距离相等，则向下舍入。如果被舍弃部分 > 0.5，则舍入行为同 RoundingMode.UP；否则舍入行为同RoundingMode.DOWN。

示例：

<table> 
 <tbody> 
  <tr> 
   <th>输入数字</th> 
   <th>使用&nbsp;HALF_DOWN&nbsp;舍入模式<br> 将输入数字舍入为一位数</th> 
  </tr> 
  <tr> 
   <td>5.5</td> 
   <td>5</td> 
  </tr> 
  <tr> 
   <td>2.5</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>1.6</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>1.1</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>1.0</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>-1.0</td> 
   <td>-1</td> 
  </tr> 
  <tr> 
   <td>-1.1</td> 
   <td>-1</td> 
  </tr> 
  <tr> 
   <td>-1.6</td> 
   <td>-2</td> 
  </tr> 
  <tr> 
   <td>-2.5</td> 
   <td>-2</td> 
  </tr> 
  <tr> 
   <td>-5.5</td> 
   <td>-5</td> 
  </tr> 
 </tbody> 
</table>

HALF\_EVEN

public static final RoundingMode HALF_EVEN

向最接近数字方向舍入的舍入模式，如果与两个相邻数字的距离相等，则向相邻的偶数舍入。如果舍弃部分左边的数字为奇数，则舍入行为同RoundingMode.HALF\_UP；如果为偶数，则舍入行为同RoundingMode.HALF\_DOWN。注意，在重复进行一系列计算时，此舍入模式可以在统计上将累加错误减到最小。此舍入模式也称为“银行家舍入法”，主要在美国使用。此舍入模式类似于 Java 中对float 和double 算法使用的舍入策略。

示例：

<table> 
 <tbody> 
  <tr> 
   <th>输入数字</th> 
   <th>使用&nbsp;HALF_EVEN&nbsp;舍入模式<br> 将输入数字舍入为一位数</th> 
  </tr> 
  <tr> 
   <td>5.5</td> 
   <td>6</td> 
  </tr> 
  <tr> 
   <td>2.5</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>1.6</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>1.1</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>1.0</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>-1.0</td> 
   <td>-1</td> 
  </tr> 
  <tr> 
   <td>-1.1</td> 
   <td>-1</td> 
  </tr> 
  <tr> 
   <td>-1.6</td> 
   <td>-2</td> 
  </tr> 
  <tr> 
   <td>-2.5</td> 
   <td>-2</td> 
  </tr> 
  <tr> 
   <td>-5.5</td> 
   <td>-6</td> 
  </tr> 
 </tbody> 
</table>

UNNECESSARY

public static final RoundingMode UNNECESSARY

用于断言请求的操作具有精确结果的舍入模式，因此不需要舍入。如果对生成精确结果的操作指定此舍入模式，则抛出 ArithmeticException。

示例：

<table> 
 <tbody> 
  <tr> 
   <th>输入数字</th> 
   <th>使用&nbsp;UNNECESSARY&nbsp;舍入模式<br> 将输入数字舍入为一位数</th> 
  </tr> 
  <tr> 
   <td>5.5</td> 
   <td>抛出&nbsp;ArithmeticException</td> 
  </tr> 
  <tr> 
   <td>2.5</td> 
   <td>抛出&nbsp;ArithmeticException</td> 
  </tr> 
  <tr> 
   <td>1.6</td> 
   <td>抛出&nbsp;ArithmeticException</td> 
  </tr> 
  <tr> 
   <td>1.1</td> 
   <td>抛出&nbsp;ArithmeticException</td> 
  </tr> 
  <tr> 
   <td>1.0</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>-1.0</td> 
   <td>-1</td> 
  </tr> 
  <tr> 
   <td>-1.1</td> 
   <td>抛出&nbsp;ArithmeticException</td> 
  </tr> 
  <tr> 
   <td>-1.6</td> 
   <td>抛出&nbsp;ArithmeticException</td> 
  </tr> 
  <tr> 
   <td>-2.5</td> 
   <td>抛出&nbsp;ArithmeticException</td> 
  </tr> 
  <tr> 
   <td>-5.5</td> 
   <td>抛出&nbsp;ArithmeticException</td> 
  </tr> 
 </tbody> 
</table>