to top
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

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

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

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

public static final RoundingMode HALF_DOWN

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

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.

public static final RoundingMode HALF_UP

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

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.

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

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