Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public final enum

RoundingMode

extends Enum <E extends  Enum <E>>
java.lang.Object
   ↳ java.lang.Enum <E extends  java.lang.Enum <E>>
     ↳ java.math.RoundingMode

Class Overview

Specifies the rounding behavior for operations whose results cannot be represented exactly.

Summary

Enum Values
RoundingMode   CEILING  Rounding mode to round towards positive infinity. 
RoundingMode   DOWN  Rounding mode where the values are rounded towards zero. 
RoundingMode   FLOOR  Rounding mode to round towards negative infinity. 
RoundingMode   HALF_DOWN  Rounding mode where values are rounded towards the nearest neighbor. 
RoundingMode   HALF_EVEN  Rounding mode where values are rounded towards the nearest neighbor. 
RoundingMode   HALF_UP  Rounding mode where values are rounded towards the nearest neighbor. 
RoundingMode   UNNECESSARY  Rounding mode where the rounding operations throws an ArithmeticException for the case that rounding is necessary, i.e. 
RoundingMode   UP  Rounding mode where positive values are rounded towards positive infinity and negative values towards negative infinity. 
Public Methods
static RoundingMode valueOf (int mode)
Converts rounding mode constants from class BigDecimal into RoundingMode values.
static RoundingMode valueOf ( String name)
final static RoundingMode[] values ()
[Expand]
Inherited Methods
From class java.lang.Enum
From class java.lang.Object
From interface java.lang.Comparable

Enum Values

public static final RoundingMode CEILING

Added in API level 1

Rounding mode to round towards positive infinity. For positive values this rounding mode behaves as UP , for negative values as DOWN .
Rule: x.round() >= x

public static final RoundingMode DOWN

Added in API level 1

Rounding mode where the values are rounded towards zero.
Rule: x.round().abs() <= x.abs()

public static final RoundingMode FLOOR

Added in API level 1

Rounding mode to round towards negative infinity. For positive values this rounding mode behaves as DOWN , for negative values as UP .
Rule: x.round() <= x

public static final RoundingMode HALF_DOWN

Added in API level 1

Rounding mode where values are rounded towards the nearest neighbor. Ties are broken by rounding down.

public static final RoundingMode HALF_EVEN

Added in API level 1

Rounding mode where values are rounded towards the nearest neighbor. Ties are broken by rounding to the even neighbor.

public static final RoundingMode HALF_UP

Added in API level 1

Rounding mode where values are rounded towards the nearest neighbor. Ties are broken by rounding up.

public static final RoundingMode UNNECESSARY

Added in API level 1

Rounding mode where the rounding operations throws an ArithmeticException for the case that rounding is necessary, i.e. for the case that the value cannot be represented exactly.

public static final RoundingMode UP

Added in API level 1

Rounding mode where positive values are rounded towards positive infinity and negative values towards negative infinity.
Rule: x.round().abs() >= x.abs()

Public Methods

public static RoundingMode valueOf (int mode)

Added in API level 1

Converts rounding mode constants from class BigDecimal into RoundingMode values.

Parameters
mode rounding mode constant as defined in class BigDecimal
Returns
  • corresponding rounding mode object

public static RoundingMode valueOf ( String name)

Added in API level 1

public static final RoundingMode[] values ()

Added in API level 1