【2026年7月版】Java BigDecimalのcompareTo比較・使い方を完全解説｜double精度問題の解決から金融計算の実践まで

この記事の内容

1. 01BigDecimalとは？doubleではダメな理由
2. 02BigDecimalの基本：生成・四則演算・スケール
3. 03compareToで大小比較する方法
4. 04equalsとcompareToの違いと落とし穴
5. 05BigDecimalの実践活用：金融・消費税・為替計算
6. 06BigDecimalのよくあるミスとその対策
7. 07【独自】Claude CodeでBigDecimal処理を即座に実装する
8. FAQよくある質問

// doubleの計算に潜む罠
public class DoubleTest {
    public static void main(String[] args) {
        double a = 1.0;
        double b = 0.9;
        System.out.println(a - b);  // 0.1を期待するが...

        // 実際の出力: 0.09999999999999998
        // !!!0.1ではない!!!
    }
}

📚 用語解説

浮動小数点数（Floating Point Number）：コンピュータが小数を表現するための方式。IEEE 754標準に基づき、符号・仮数部・指数部の3つで数値を表す。Javaのfloat（32bit）とdouble（64bit）が浮動小数点数型。表現できる値の範囲は広いが、2進数の近似誤差が生じる。お金・数量・割合など精度が重要な計算には不向き。

import java.math.BigDecimal;
import java.math.MathContext;

// ===== 正しい生成方法 =====

// 方法1: 文字列から生成（推奨！誤差なし）
BigDecimal bd1 = new BigDecimal("1.5");
BigDecimal bd2 = new BigDecimal("0.1");

// 方法2: valueOf（double→文字列を経由するため誤差なし）
BigDecimal bd3 = BigDecimal.valueOf(1.5);
BigDecimal bd4 = BigDecimal.valueOf(100);

// ===== NG: やってはいけない生成方法 =====
// doubleから直接生成するとdoubleの誤差を引き継ぐ！
BigDecimal bad = new BigDecimal(0.1);  // NG!!
// bad.toString() → "0.1000000000000000055511151231257827021181583404541015625"
// 見た目は0.1に見えるが、内部に誤差が含まれる

new BigDecimal(0.1)と書くと、0.1のdoubleの近似値がそのままBigDecimalになってしまいます。文字列で渡すnew BigDecimal("0.1")かBigDecimal.valueOf(0.1)を使うことで、意図した正確な値のBigDecimalが作れます。これはBigDecimal最重要の注意点です。

📚 用語解説

スケール（Scale）：BigDecimalで小数点以下の桁数を表すプロパティ。例えばnew BigDecimal("1.50")のスケールは2、new BigDecimal("1.5")のスケールは1。同じ数値でもスケールが異なるとequals()ではfalseになる（1.50 ≠ 1.5）が、compareTo()では同じ（1.50 == 1.5）として扱われる。これがequals()を使ってはいけない理由の核心。

📚 用語解説

RoundingMode（丸めモード）：BigDecimalの除算や小数点以下桁数を制限する際の丸め処理方式。HALF_UP（四捨五入）・FLOOR（切り捨て）・CEILING（切り上げ）・HALF_EVEN（銀行の丸め）等がある。divide()メソッドで割り切れない値を計算する際はRoundingModeを必ず指定しないとArithmeticExceptionが発生する。消費税計算ではFLOOR（切り捨て）またはHALF_UP（四捨五入）が一般的。

import java.math.BigDecimal;
import java.math.RoundingMode;

BigDecimal price = new BigDecimal("1000");
BigDecimal taxRate = new BigDecimal("0.10");
BigDecimal discount = new BigDecimal("100");

// 消費税の計算（小数点以下は四捨五入）
BigDecimal tax = price.multiply(taxRate)
                      .setScale(0, RoundingMode.HALF_UP);
System.out.println("消費税: " + tax);  // 100

// 税込み価格 = 本体価格 + 消費税
BigDecimal totalPrice = price.add(tax);
System.out.println("税込み: " + totalPrice);  // 1100

// 割引後の価格
BigDecimal discountedPrice = totalPrice.subtract(discount);
System.out.println("割引後: " + discountedPrice);  // 1000

// 単価と数量から合計（10個購入）
BigDecimal quantity = new BigDecimal("10");
BigDecimal total = price.multiply(quantity);
System.out.println("10個の合計: " + total);  // 10000

📚 用語解説

compareToメソッド：java.lang.Comparableインターフェースで定義された比較メソッド。a.compareTo(b)を呼び出したとき、aがbより小さければ負の整数（通常-1）、等しければ0、大きければ正の整数（通常1）を返す。BigDecimalだけでなく、String・Integer・LocalDateなど多くのJavaクラスが実装している。

import java.math.BigDecimal;

BigDecimal a = new BigDecimal("1.5");
BigDecimal b = new BigDecimal("2.0");
BigDecimal c = new BigDecimal("1.5");

// a.compareTo(b): aとbを比較
System.out.println(a.compareTo(b));  // -1  → a < b（aの方が小さい）
System.out.println(b.compareTo(a));  //  1  → b > a（bの方が大きい）
System.out.println(a.compareTo(c));  //  0  → a == c（等しい）

// if文での使い方
if (a.compareTo(b) < 0) {
    System.out.println("aはbより小さい");  // この行が実行される
}
if (a.compareTo(b) == 0) {
    System.out.println("aとbは等しい");
}
if (a.compareTo(b) > 0) {
    System.out.println("aはbより大きい");
}

戻り値が「マイナス（< 0）」の時、aはbより「小さい」——マイナスと小さいをセットで覚えます。反対に、戻り値が「プラス（> 0）」の時、aはbより「大きい」。0の時は「等しい」。これを3秒で思い出せるようになれば十分です。

import java.math.BigDecimal;

public class CompareDemo {
    // 在庫量が最低在庫量を下回っているか判定
    public static boolean isLowStock(BigDecimal currentStock,
                                      BigDecimal minimumStock) {
        // currentStock < minimumStock の場合trueを返す
        return currentStock.compareTo(minimumStock) < 0;
    }

    // 2つの金額のうち大きい方を返す
    public static BigDecimal maxAmount(BigDecimal a, BigDecimal b) {
        return (a.compareTo(b) >= 0) ? a : b;
    }

    // 金額が上限を超えているかチェック
    public static boolean exceedsLimit(BigDecimal amount, BigDecimal limit) {
        return amount.compareTo(limit) > 0;
    }

    public static void main(String[] args) {
        BigDecimal current = new BigDecimal("5");
        BigDecimal minimum = new BigDecimal("10");
        System.out.println(isLowStock(current, minimum));  // true（在庫不足）

        BigDecimal price1 = new BigDecimal("1980");
        BigDecimal price2 = new BigDecimal("2480");
        System.out.println(maxAmount(price1, price2));  // 2480（高い方を返す）

        BigDecimal purchase = new BigDecimal("1500000");
        BigDecimal creditLimit = new BigDecimal("1000000");
        System.out.println(exceedsLimit(purchase, creditLimit));  // true（上限超過）
    }
}

import java.math.BigDecimal;
import java.util.Arrays;
import java.util.List;
import java.util.ArrayList;
import java.util.Collections;

public class BigDecimalSort {
    public static void main(String[] args) {
        List<BigDecimal> prices = new ArrayList<>(Arrays.asList(
            new BigDecimal("3980"),
            new BigDecimal("1280"),
            new BigDecimal("5800"),
            new BigDecimal("980"),
            new BigDecimal("2500")
        ));

        // 昇順ソート（安い順）— Comparator.naturalOrder()またはcompareTo使用
        prices.sort(BigDecimal::compareTo);
        System.out.println("昇順: " + prices);
        // [980, 1280, 2500, 3980, 5800]

        // 降順ソート（高い順）
        prices.sort((a, b) -> b.compareTo(a));
        System.out.println("降順: " + prices);
        // [5800, 3980, 2500, 1280, 980]

        // 最小値・最大値
        BigDecimal min = prices.stream()
                               .min(BigDecimal::compareTo)
                               .orElse(BigDecimal.ZERO);
        BigDecimal max = prices.stream()
                               .max(BigDecimal::compareTo)
                               .orElse(BigDecimal.ZERO);
        System.out.println("最安値: " + min + ", 最高値: " + max);
    }
}

import java.math.BigDecimal;

BigDecimal a = new BigDecimal("1.50");  // スケール=2
BigDecimal b = new BigDecimal("1.5");   // スケール=1

// equals: スケールも含めて厳密に比較
System.out.println(a.equals(b));           // false !!! ← 落とし穴
System.out.println(a.equals(new BigDecimal("1.50")));  // true

// compareTo: 数値の大小のみ比較（スケール無視）
System.out.println(a.compareTo(b) == 0);  // true ← 正しい比較
System.out.println(a.compareTo(new BigDecimal("1.50")) == 0); // true

new BigDecimal("1.50").equals(new BigDecimal("1.5"))はfalseを返します。これはスケール（小数点以下の桁数）が異なるためです。1.50のスケールは2、1.5のスケールは1で、equalsはスケールも含めて厳密に比較するためです。等値確認にはcompareTo(other) == 0を使うことが鉄則です。

import java.math.BigDecimal;
import java.math.RoundingMode;

public class TaxCalculator {
    private static final BigDecimal TAX_RATE = new BigDecimal("0.10"); // 10%

    // 消費税を計算（切り捨て）
    public static BigDecimal calcTax(BigDecimal price) {
        return price.multiply(TAX_RATE).setScale(0, RoundingMode.FLOOR);
    }

    // 税込み価格（本体価格 + 消費税）
    public static BigDecimal calcTaxIncluded(BigDecimal price) {
        BigDecimal tax = calcTax(price);
        return price.add(tax);
    }

    // 税抜き価格を計算（税込み÷1.1、小数点以下切り捨て）
    public static BigDecimal calcTaxExcluded(BigDecimal taxIncludedPrice) {
        BigDecimal divisor = BigDecimal.ONE.add(TAX_RATE); // 1 + 0.10 = 1.10
        return taxIncludedPrice.divide(divisor, 0, RoundingMode.FLOOR);
    }

    public static void main(String[] args) {
        BigDecimal price = new BigDecimal("980");
        System.out.println("本体価格: " + price + "円");
        System.out.println("消費税: " + calcTax(price) + "円");       // 98円
        System.out.println("税込み: " + calcTaxIncluded(price) + "円"); // 1078円

        BigDecimal taxIncluded = new BigDecimal("1078");
        System.out.println("税抜き逆算: " + calcTaxExcluded(taxIncluded) + "円"); // 980円
    }
}

import java.math.BigDecimal;
import java.math.RoundingMode;

public class CurrencyConverter {
    // ドルを円に換算（小数点2位まで）
    public static BigDecimal usdToJpy(BigDecimal usd, BigDecimal exchangeRate) {
        return usd.multiply(exchangeRate).setScale(2, RoundingMode.HALF_UP);
    }

    // 基準レートより高いか判定（割高判定）
    public static boolean isOverRate(BigDecimal currentRate, BigDecimal baseRate) {
        return currentRate.compareTo(baseRate) > 0;
    }

    public static void main(String[] args) {
        BigDecimal usdAmount = new BigDecimal("100.00");
        BigDecimal exchangeRate = new BigDecimal("155.23");  // 1ドル=155.23円

        BigDecimal jpyAmount = usdToJpy(usdAmount, exchangeRate);
        System.out.println("100ドル = " + jpyAmount + "円"); // 15523.00円

        BigDecimal baseRate = new BigDecimal("150.00");
        if (isOverRate(exchangeRate, baseRate)) {
            System.out.println("基準レートより円安（割高）です");
        }
    }
}

import java.math.BigDecimal;
import java.math.RoundingMode;
import java.util.List;

public class OrderCalculator {
    record OrderItem(String name, BigDecimal price, int quantity) {}

    // 合計金額を計算（全商品の価格×数量の合計）
    public static BigDecimal calcTotal(List<OrderItem> items) {
        BigDecimal total = BigDecimal.ZERO;
        for (OrderItem item : items) {
            BigDecimal subtotal = item.price()
                .multiply(new BigDecimal(item.quantity()));
            total = total.add(subtotal);
        }
        return total;
    }

    public static void main(String[] args) {
        List<OrderItem> order = List.of(
            new OrderItem("Tシャツ", new BigDecimal("2980"), 2),
            new OrderItem("ジーンズ", new BigDecimal("7800"), 1),
            new OrderItem("靴下", new BigDecimal("490"), 3)
        );

        BigDecimal total = calcTotal(order);
        System.out.println("合計: " + total + "円");  // 15230円

        // 合計が10000円以上なら送料無料
        BigDecimal freeShippingThreshold = new BigDecimal("10000");
        if (total.compareTo(freeShippingThreshold) >= 0) {
            System.out.println("送料無料！");
        }
    }
}

📚 用語解説

immutableオブジェクト（不変オブジェクト）：一度生成されたら内部状態を変更できないオブジェクト。JavaのBigDecimal・String・Integerなどが代表例。「total.add(amount)」と書いてもtotalは変わらず、新しいBigDecimalが戻り値として返される。そのため計算結果は「total = total.add(amount)」のように必ず変数に代入する必要がある。immutableオブジェクトはスレッドセーフで安全というメリットがある。

BigDecimalのオブジェクトは一度生成したら変更できない（immutable）です。add()・multiply()等のメソッドは元のオブジェクトを変更するのではなく、計算結果の新しいBigDecimalを返します。そのため「total.add(amount);」と書いても何も起きません。必ず「total = total.add(amount);」と戻り値を変数に代入してください。

// Claude Codeへの指示例:
// 「以下のコードのBigDecimalの使い方に問題がないか確認して。
//  特にdoubleコンストラクタ・equals使用・RoundingMode省略の問題を見つけて」

// 問題のあるコード
public BigDecimal calculateTotal(double price, int quantity) {
    BigDecimal bd = new BigDecimal(price);  // ← 問題1: doubleコンストラクタ
    BigDecimal qty = new BigDecimal(quantity);
    BigDecimal total = bd.multiply(qty);
    if (total.equals(new BigDecimal("10000"))) {  // ← 問題2: equals比較
        return total.divide(new BigDecimal("1.1")); // ← 問題3: RoundingModeなし
    }
    return total;
}

// Claude Codeが提案する修正コード:
public BigDecimal calculateTotal(String price, int quantity) {
    BigDecimal bd = new BigDecimal(price);  // ← 文字列に変更
    BigDecimal qty = new BigDecimal(quantity);
    BigDecimal total = bd.multiply(qty);
    if (total.compareTo(new BigDecimal("10000")) == 0) {  // ← compareTo == 0
        return total.divide(new BigDecimal("1.1"), 2, RoundingMode.HALF_UP); // ← RoundingMode追加
    }
    return total;
}

NEXT STEP

この記事の内容を、あなたのビジネスで
実践してみませんか？