Understanding and Using Java BigDecimal for Precise Calculations

Java's java.math.BigDecimal provides arbitrary‑precision decimal arithmetic, useful when double 's 16‑digit precision is insufficient.

BigDecimal objects cannot be operated with + , - , * , / ; instead use methods such as add , subtract , multiply , divide , etc. Constructors include BigDecimal(int) , BigDecimal(double) , BigDecimal(long) , BigDecimal(String) .

Example of precision loss when using the double constructor versus the String constructor:

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);

Output shows a = 0.10000000000000000555… , b = 0.1 . Therefore, prefer the String constructor or BigDecimal.valueOf(double) for predictable results.

Common methods: add(BigDecimal) , subtract(BigDecimal) , multiply(BigDecimal) , divide(BigDecimal) , toString() , doubleValue() , floatValue() , longValue() , intValue() .

BigDecimal comparison uses compareTo :

int a = bigDecimal.compareTo(bigDecimal2);
// a = -1 if less, 0 if equal, 1 if greater

Formatting with java.text.NumberFormat can format BigDecimal as currency or percent:

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));

Result: 贷款金额: ￥15,000.48 利率: 0.8% 利息: ￥120.00

Formatting helper method example ( formatToNumber ) ensures two‑decimal output, handling values <1, =0, and >1.

public static String formatToNumber(BigDecimal obj) {
    DecimalFormat df = new DecimalFormat("#.00");
    if (obj.compareTo(BigDecimal.ZERO) == 0) {
        return "0.00";
    } else if (obj.compareTo(BigDecimal.ZERO) > 0 && obj.compareTo(new BigDecimal(1)) < 0) {
        return "0" + df.format(obj).toString();
    } else {
        return df.format(obj).toString();
    }
}

Common exception: dividing with a non‑terminating decimal expansion throws ArithmeticException . Resolve by specifying scale in divide or using a rounding mode.

BigDecimal result = a.divide(b, 2, BigDecimal.ROUND_HALF_UP);

Utility class ArithmeticUtils provides static methods for precise addition, subtraction, multiplication, division, rounding, remainder, and comparison using BigDecimal .

package com.vivo.ars.util;
import java.math.BigDecimal;
public class ArithmeticUtils {
    private static final int DEF_DIV_SCALE = 10;
    public static double add(double v1, double v2) { /* ... */ }
    public static BigDecimal add(String v1, String v2) { /* ... */ }
    // other methods omitted for brevity
}

In summary, use BigDecimal for calculations requiring exact decimal precision, prefer String constructors, and be aware of the performance overhead compared to primitive floating‑point types.