枚举 RoundingMode

java.math
枚举 RoundingMode

java.lang.Object

  java.lang.Enum
<RoundingMode
>
      java.math.RoundingMode

所有已实现的接口：

Serializable , Comparable < RoundingMode >

---

public enum RoundingMode

extends Enum < RoundingMode >

为可能丢弃精度的数值操作指定一种舍入行为 。每种舍入模式都指示如何计算返回舍入结果位数的最低有效位。如果返回的位数比表示精确数值结果所需的位数少，则舍弃的位数称为舍弃部分 ，而不管这些位数对数值的作用如何。换句话说，假设是一个数值，舍弃部分的绝对值可能大于 1。

每种舍入模式的描述包括一个表，列出如何在相关的舍入模式下将不同的两位十进制数舍入为一位十进制数。表中的结果栏可以通过以下方式获得：使用指定的值创建一个 BigDecimal 数字，形成一个具有适当设置（precision 设置为 1 ，roundingMode 设置为相关的舍入模式）的 MathContext 对象，并使用适当的 MathContext 对此数字调用 round 。下面是一个汇总表，该表显示了在所有舍入模式下这些舍入操作的结果。

 

不同舍入模式下的舍入操作汇总

根据给定的舍入模式将输入数字舍入为一位数的结果 输入数字 UP DOWN CEILING FLOOR HALF_UP HALF_DOWN HALF_EVEN UNNECESSARY 5.5 6 5 6 5 6 5 6 抛出 ArithmeticException 2.5 3 2 3 2 3 2 2 抛出 ArithmeticException 1.6 2 1 2 1 2 2 2 抛出 ArithmeticException 1.1 2 1 2 1 1 1 1 抛出 ArithmeticException 1.0 1 1 1 1 1 1 1 1 -1.0 -1 -1 -1 -1 -1 -1 -1 -1 -1.1 -2 -1 -1 -2 -1 -1 -1 抛出 ArithmeticException -1.6 -2 -1 -1 -2 -2 -2 -2 抛出 ArithmeticException -2.5 -3 -2 -2 -3 -3 -2 -2 抛出 ArithmeticException -5.5 -6 -5 -5 -6 -6 -5 -6 抛出 ArithmeticException

此 enum 拟用于取代 BigDecimal （BigDecimal.ROUND_UP 、BigDecimal.ROUND_DOWN 等）中舍入模式常量的基于整数的枚举。

 

 

另请参见：

BigDecimal , MathContext

---

枚举常量摘要
CEILING           向正无限大方向舍入的舍入模式。
DOWN           向零方向舍入的舍入模式。
FLOOR           向负无限大方向舍入的舍入模式。
HALF_DOWN           向最接近数字方向舍入的舍入模式，如果与两个相邻数字的距离相等，则向下舍入。
HALF_EVEN           向最接近数字方向舍入的舍入模式，如果与两个相邻数字的距离相等，则向相邻的偶数舍入。
HALF_UP           向最接近数字方向舍入的舍入模式，如果与两个相邻数字的距离相等，则向上舍入。
UNNECESSARY           用于断言请求的操作具有精确结果的舍入模式，因此不需要舍入。
UP           远离零方向舍入的舍入模式。

 

方法摘要
static RoundingMode	valueOf (int rm)           返回与 BigDecimal 中遗留整数舍入模式常量对应的 RoundingMode 对象。
static RoundingMode	valueOf (String  name)           返回带有指定名称的该类型的枚举常量。
static RoundingMode []	values ()           按照声明该枚举类型的常量的顺序，返回 包含这些常量的数组。

 

从类 java.lang.Enum 继承的方法
clone , compareTo , equals , getDeclaringClass , hashCode , name , ordinal , toString , valueOf

 

从类 java.lang.Object 继承的方法
finalize , getClass , notify , notifyAll , wait , wait , wait

 

枚举常量详细信息

UP

public static final RoundingMode
 UP

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

示例：

输入数字	使用 UP 舍入模式 将输入数字舍入为一位数
5.5	6
2.5	3
1.6	2
1.1	2
1.0	1
-1.0	-1
-1.1	-2
-1.6	-2
-2.5	-3
-5.5	-6

 

---

DOWN

public static final RoundingMode
 DOWN

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

示例：

输入数字	使用 DOWN 舍入模式 将输入数字舍入为一位数
5.5	5
2.5	2
1.6	1
1.1	1
1.0	1
-1.0	-1
-1.1	-1
-1.6	-1
-2.5	-2
-5.5	-5

 

---

CEILING

public static final RoundingMode
 CEILING

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

示例：

输入数字	使用 CEILING 舍入模式 将输入数字舍入为一位数
5.5	6
2.5	3
1.6	2
1.1	2
1.0	1
-1.0	-1
-1.1	-1
-1.6	-1
-2.5	-2
-5.5	-5

 

---

FLOOR

public static final RoundingMode
 FLOOR

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

示例：

输入数字	使用 FLOOR 舍入模式 将输入数字舍入为一位数
5.5	5
2.5	2
1.6	1
1.1	1
1.0	1
-1.0	-1
-1.1	-2
-1.6	-2
-2.5	-3
-5.5	-6

 

---

HALF_UP

public static final RoundingMode
 HALF_UP

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

示例：

输入数字	使用 HALF_UP 舍入模式 将输入数字舍入为一位数
5.5	6
2.5	3
1.6	2
1.1	1
1.0	1
-1.0	-1
-1.1	-1
-1.6	-2
-2.5	-3
-5.5	-6

 

---

HALF_DOWN

public static final RoundingMode
 HALF_DOWN

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

示例：

输入数字	使用 HALF_DOWN 舍入模式 将输入数字舍入为一位数
5.5	5
2.5	2
1.6	2
1.1	1
1.0	1
-1.0	-1
-1.1	-1
-1.6	-2
-2.5	-2
-5.5	-5

 

---

HALF_EVEN

public static final RoundingMode
 HALF_EVEN

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

示例：

输入数字	使用 HALF_EVEN 舍入模式 将输入数字舍入为一位数
5.5	6
2.5	2
1.6	2
1.1	1
1.0	1
-1.0	-1
-1.1	-1
-1.6	-2
-2.5	-2
-5.5	-6

 

---

UNNECESSARY

public static final RoundingMode
 UNNECESSARY

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

示例：

输入数字	使用 UNNECESSARY 舍入模式 将输入数字舍入为一位数
5.5	抛出 ArithmeticException
2.5	抛出 ArithmeticException
1.6	抛出 ArithmeticException
1.1	抛出 ArithmeticException
1.0	1
-1.0	-1
-1.1	抛出 ArithmeticException
-1.6	抛出 ArithmeticException
-2.5	抛出 ArithmeticException
-5.5	抛出 ArithmeticException

 

方法详细信息

values

public static final RoundingMode
[] values
()

按照声明该枚举类型的常量的顺序，返回 包含这些常量的数组。该方法可用于迭代 常量，如下所示：

for(RoundingMode c :RoundingMode.values())
        System.out.println(c);

 

返回：

按照声明该枚举类型的常量的顺序，返回 包含这些常量的数组。

---

valueOf

public static RoundingMode
 valueOf
(String
 name)

返回带有指定名称的该类型的枚举常量。 字符串必须与用于声明该类型的枚举常量的 标识符 完全 匹配。（不允许有多余 的空格。）

 

参数：

指定要返回的枚举常量的名称。 -

返回：

返回带有指定名称的枚举常量

抛出：

如果该枚举类型没有带有指定名称的常量， - 则抛出 IllegalArgumentException

---

valueOf

public static RoundingMode
 valueOf
(int rm)

返回与 BigDecimal 中遗留整数舍入模式常量对应的 RoundingMode 对象。

 

参数：

rm - 要转换的遗留整数舍入模式

返回：

与给定整数对应的 RoundingMode 。

抛出：

IllegalArgumentException - 整数超出范围