Java.math.BigDecimal.divide() Method



The java.math.BigDecimal.divide(BigDecimal divisor, int roundingMode) returns a BigDecimal whose value is (this / divisor), and whose scale is this.scale(). If rounding must be performed to generate a result with the given scale, the specified rounding mode is applied.


Following is the declaration for java.math.BigDecimal.divide() method.

public BigDecimal divide(BigDecimal divisor, int roundingMode)


  • divisor − Value by which this BigDecimal is to be divided.

  • roundingMode − Rounding mode to apply.

Return Value

This method returns a BigDecimal object whose value is this / divisor, rounded as specified.


  • ArithmeticException − If divisor == 0, or roundingMode == ROUND_UNNECESSARY and this.scale() is insufficient to represent the result of the division exactly.

  • IllegalArgumentException − If roundingMode does not represent a valid rounding mode.


The following example shows the usage of math.BigDecimal.divide() method.

package com.tutorialspoint;

import java.math.*;

public class BigDecimalDemo {

   public static void main(String[] args) {

      // create 3 BigDecimal objects
      BigDecimal bg1, bg2, bg3;

      bg1 = new BigDecimal("16");
      bg2 = new BigDecimal("3");

      // divide bg1 with bg2
      // 0 specifies BigDecimal.ROUND_UP
      bg3 = bg1.divide(bg2, 0);

      String str = "Division result is " +bg3;

      // print bg3 value
      System.out.println( str );

Let us compile and run the above program, this will produce the following result −

Division result is 6