compact1, compact2, compact3

java.math

Enum RoundingMode

java.lang.Object

java.lang.Enum<RoundingMode>

java.math.RoundingMode

All Implemented Interfaces:

Serializable Comparable RoundingMode >，<

public enum RoundingMode
extends Enum<RoundingMode>

指定一个数值运算精度舍入行为能够丢弃。每一个四舍五入模式表明如何计算一个圆形的结果的最不重要的返回数字。如果返回的是更少的位比需要精确的数值结果的位数，丢弃的数字将被称为丢弃的分数无论数字的贡献值。换句话说，被认为是一个数值，丢弃的分数可以有一个绝对值大于一个。

每一个四舍五入的模式描述包括一个表，列出在四舍五入模式下，不同的两位的两位十进制数会如何圆至一一位的十进制数值。表中的结果列可以通过使用指定的值创建一个BigDecimal数了，形成了一个具有适当的设置MathContext对象（precision设置1，而设定的舍入模式问题的roundingMode），并称round这个号码与适当的MathContext。显示所有四舍五入模式的这些四舍五入操作的结果的摘要表。

Summary of Rounding Operations Under Different Rounding Modes

	Result of rounding input to one digit with the given rounding mode
Input Number	UP	DOWN	CEILING	FLOOR	HALF_UP	HALF_DOWN	HALF_EVEN	UNNECESSARY
5.5	6	5	6	5	6	5	6	throw ArithmeticException
2.5	3	2	3	2	3	2	2	throw ArithmeticException
1.6	2	1	2	1	2	2	2	throw ArithmeticException
1.1	2	1	2	1	1	1	1	throw 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	throw ArithmeticException
-1.6	-2	-1	-1	-2	-2	-2	-2	throw ArithmeticException
-2.5	-3	-2	-2	-3	-3	-2	-2	throw ArithmeticException
-5.5	-6	-5	-5	-6	-6	-5	-6	throw ArithmeticException

这枚举旨在取代基于整数舍入模式BigDecimal枚举常数（BigDecimal.ROUND_UP，BigDecimal.ROUND_DOWN，等）。

从以下版本开始：

一点五

另请参见：

BigDecimal， MathContext

Enum Constant Summary

Enum Constants

Enum Constant and Description
CEILING 圆向正无穷大的圆整圆。
DOWN 圆对零的圆整。
FLOOR 圆对负无穷大的四舍五入模式。
HALF_DOWN 舍入到“近邻”除非两边距离相等，在这种情况下，本轮下跌。
HALF_EVEN 舍入到“近邻”除非两边距离相等，在这种情况下，对连邻居轮。
HALF_UP 舍入到“近邻”除非两边距离相等，在这种情况下，圆了。
UNNECESSARY 四舍五入模式断言，所请求的操作有一个确切的结果，因此没有四舍五入是必要的。
UP 圆距离为零的四舍五入模式。

方法摘要

Modifier and Type	Method and Description
static RoundingMode	valueOf(int rm) 返回一个整数舍入模式的不断 BigDecimal遗留在相应的 RoundingMode对象。
static RoundingMode	valueOf(String name) 返回此类型具有指定名称的枚举常量。
static RoundingMode[]	values() 返回一个数组包含该枚举类型的常量，它们的顺序声明。

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

UP

public static final RoundingMode UP

圆距离为零的四舍五入模式。总是递增的数字之前，一个非零丢弃分数。请注意，此四舍五入模式永远不会降低计算值的大小。

例子:

Rounding mode UP Examples

Input Number	Input rounded to one digit with UP rounding
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

圆对零的圆整。没有增量的数字被丢弃的分数之前（即截断）。请注意，此四舍五入模式永远不会增加计算出的值的大小。

例子:

Rounding mode DOWN Examples

Input Number	Input rounded to one digit with DOWN rounding
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。请注意，此四舍五入模式从未降低计算出的值。

例子:

Rounding mode CEILING Examples

Input Number	Input rounded to one digit with CEILING rounding
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。请注意，此四舍五入模式不会增加计算出的值。

例子:

Rounding mode FLOOR Examples

Input Number	Input rounded to one digit with FLOOR rounding
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

舍入到“近邻”除非两边距离相等，在这种情况下，圆了。表现为 RoundingMode.UP如果丢弃的分数≥0.5；否则，表现为 RoundingMode.DOWN。请注意，这是在学校常用的四舍五入模式。

例子:

Rounding mode HALF_UP Examples

Input Number	Input rounded to one digit with HALF_UP rounding
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

舍入到“近邻”除非两边距离相等，在这种情况下，本轮下跌。表现为 RoundingMode.UP如果丢弃率＞0.5；否则，表现为 RoundingMode.DOWN。

例子:

Rounding mode HALF_DOWN Examples

Input Number	Input rounded to one digit with HALF_DOWN rounding
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如果它甚至。请注意，这是四舍五入模式，统计最大限度地减少累积误差时，反复应用在一个序列的计算。它有时被称为“银行家舍入，“主要是用在USA.这种舍入模式类似于舍入策略用于java float和 double算法。

例子:

Rounding mode HALF_EVEN Examples

Input Number	Input rounded to one digit with HALF_EVEN rounding
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抛出。

例子:

Rounding mode UNNECESSARY Examples

Input Number	Input rounded to one digit with UNNECESSARY rounding
5.5	throw ArithmeticException
2.5	throw ArithmeticException
1.6	throw ArithmeticException
1.1	throw ArithmeticException
1.0	1
-1.0	-1
-1.1	throw ArithmeticException
-1.6	throw ArithmeticException
-2.5	throw ArithmeticException
-5.5	throw ArithmeticException

方法详细信息

values

public static RoundingMode[] values()

返回一个数组包含该枚举类型的常量，它们的顺序声明。这种方法可以用来遍历常数如下：

对于（roundingmode C：roundingmode。values()） 系统，println（C）；

结果

这个数组包含枚举类型的常量，它们的顺序声明

valueOf

public static RoundingMode valueOf(String name)

返回此类型具有指定名称的枚举常量。字符串必须匹配确切地用来声明一个枚举本型常数标识符。（多余空格的字符是不允许的。）

参数

name -定要返回的枚举的名称。

结果

具有指定名称的枚举常量

异常

IllegalArgumentException -如果这个枚举类型，也没有固定的具有指定名称

NullPointerException -如果参数为空

valueOf

public static RoundingMode valueOf(int rm)

返回一个整数舍入模式的不断 BigDecimal遗留在相应的 RoundingMode对象。

参数

rm遗留整数舍入模式转换

结果

对给定的整数对应的 RoundingMode。

异常

IllegalArgumentException整数超出范围