Comprehensive Guide to Java BigDecimal: Overview, Constructors, Methods, Formatting, Exceptions, and Utilities

Java's java.math.BigDecimal class enables precise arithmetic for numbers exceeding the 16‑digit limit of primitive floating‑point types, making it essential when exact calculations are required.

1. BigDecimal Overview

BigDecimal objects cannot be operated on with traditional arithmetic operators; instead, their methods must be used, and constructors create immutable instances.

2. Common Constructors

BigDecimal(int) – creates an instance from an integer value.

BigDecimal(double) – creates an instance from a double value (may introduce precision issues).

BigDecimal(long) – creates an instance from a long value.

BigDecimal(String) – creates an instance from a string representation (recommended for exact values).

Example demonstrating precision differences:

BigDecimal a = new BigDecimal(0.1);
System.out.println("a values is:" + a);
System.out.println("=====================");
BigDecimal b = new BigDecimal("0.1");
System.out.println("b values is:" + b);

Result shows that the double‑based constructor yields a long, non‑terminating decimal, while the string constructor preserves the exact value 0.1.

3. Common Methods

add(BigDecimal) – returns the sum.

subtract(BigDecimal) – returns the difference.

multiply(BigDecimal) – returns the product.

divide(BigDecimal) – returns the quotient (may throw ArithmeticException if non‑terminating).

toString() – converts the value to a string.

doubleValue() , floatValue() , longValue() , intValue() – convert to primitive types.

3.1 Size Comparison

Use compareTo to compare two BigDecimal values, returning -1, 0, or 1.

int a = bigDecimal.compareTo(bigDecimal2);

4. Formatting

NumberFormat can format BigDecimal values for currency or percentages.

NumberFormat currency = NumberFormat.getCurrencyInstance();
NumberFormat percent = NumberFormat.getPercentInstance();
percent.setMaximumFractionDigits(3);
BigDecimal loanAmount = new BigDecimal("15000.48");
BigDecimal interestRate = new BigDecimal("0.008");
BigDecimal interest = loanAmount.multiply(interestRate);
System.out.println("贷款金额:\t" + currency.format(loanAmount));
System.out.println("利率:\t" + percent.format(interestRate));
System.out.println("利息:\t" + currency.format(interest));

5. Common Exceptions

5.1 Division Exception

When division results in a non‑terminating decimal, BigDecimal.divide throws ArithmeticException: Non‑terminating decimal expansion . The fix is to specify a scale and rounding mode, e.g., divide(x, 2) .

6. Summary

Use BigDecimal for high‑precision calculations, prefer the String constructor, and remember that each arithmetic operation creates a new immutable object.

6.2 Utility Class Recommendation

package com.vivo.ars.util;
import java.math.BigDecimal;
/**
 * Utility class for precise arithmetic operations.
 */
public class ArithmeticUtils {
    private static final int DEF_DIV_SCALE = 10;
    public static double add(double v1, double v2) {
        BigDecimal b1 = new BigDecimal(Double.toString(v1));
        BigDecimal b2 = new BigDecimal(Double.toString(v2));
        return b1.add(b2).doubleValue();
    }
    public static BigDecimal add(String v1, String v2) {
        BigDecimal b1 = new BigDecimal(v1);
        BigDecimal b2 = new BigDecimal(v2);
        return b1.add(b2);
    }
    // ... other methods for sub, mul, div, round, remainder, compare ...
}

The utility provides static methods for addition, subtraction, multiplication, division (with configurable scale), rounding, remainder calculation, and comparison, all using BigDecimal to ensure precision.