Save the date! Android Dev Summit is coming to Mountain View, CA on November 7-8, 2018.
added in API level 1

RoundingMode

public final enum RoundingMode
extends Enum<RoundingMode>

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


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(String name)
static RoundingMode valueOf(int mode)

Converts rounding mode constants from class BigDecimal into RoundingMode values.

static final RoundingMode[] values()

Inherited methods

Enum values

CEILING

added in API level 1
public static final RoundingMode CEILING

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

DOWN

added in API level 1
public static final RoundingMode DOWN

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

FLOOR

added in API level 1
public static final RoundingMode FLOOR

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

HALF_DOWN

added in API level 1
public static final RoundingMode HALF_DOWN

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

HALF_EVEN

added in API level 1
public static final RoundingMode HALF_EVEN

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

HALF_UP

added in API level 1
public static final RoundingMode HALF_UP

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

UNNECESSARY

added in API level 1
public static final RoundingMode UNNECESSARY

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.

UP

added in API level 1
public static final RoundingMode UP

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

Public methods

valueOf

added in API level 1
public static RoundingMode valueOf (String name)

Parameters
name String

Returns
RoundingMode

valueOf

added in API level 1
public static RoundingMode valueOf (int mode)

Converts rounding mode constants from class BigDecimal into RoundingMode values.

Parameters
mode int: rounding mode constant as defined in class BigDecimal

Returns
RoundingMode corresponding rounding mode object

values

added in API level 1
public static final RoundingMode[] values ()

Returns
RoundingMode[]