BigDecimalの基本特性
BigDecimalはJavaのjava.mathパッケージで提供される不変でスレッドセーフな高精度数値演算クラスです。16桁を超える数値の正確な計算を可能にし、任意の長さの小数部を表現できます。金融計算や科学技術計算など精度が要求される場面で重要な役割を果たします。
主要なコンストラクタ
BigDecimal(String val)- 文字列から正確な値を生成BigDecimal(double val)- double値から生成（精度注意）BigDecimal(int val)- 整数値から生成BigDecimal(long val)- long値から生成
基本的な演算メソッド
BigDecimalオブジェクトに対する演算は算術演算子ではなく専用メソッドを使用します。
import java.math.BigDecimal;
public class BigDecimalExample {
public static void main(String[] args) {
BigDecimal numA = new BigDecimal("10.5");
BigDecimal numB = new BigDecimal("3.2");
System.out.println("加算: " + numA.add(numB));
System.out.println("減算: " + numA.subtract(numB));
System.out.println("乗算: " + numA.multiply(numB));
System.out.println("除算: " + numA.divide(numB, 2, RoundingMode.HALF_UP));
}
}
丸めモードの詳細
BigDecimalでは8種類の丸めモードを提供しています：
| モード | 説明 | 例（小数点第1位まで） |
|---|---|---|
| ROUND_UP | 0から遠ざかる方向に丸め | 1.61 → 1.7 |
| ROUND_DOWN | 0に近づく方向に丸め | 1.69 → 1.6 |
| ROUND_CEILING | 正の無限大方向に丸め | 1.61 → 1.7 |
| ROUND_FLOOR | 負の無限大方向に丸め | -1.62 → -1.7 |
| ROUND_HALF_UP | 四捨五入 | 1.65 → 1.7 |
| ROUND_HALF_DOWN | 五捨六入 | 1.65 → 1.6 |
| ROUND_HALF_EVEN | 銀行家の丸め | 1.25 → 1.2 |
| ROUND_UNNECESSARY | 丸め不要（精度エラー時例外発生） | - |
BigDecimal value = new BigDecimal("2.355");
System.out.println("標準丸め: " + value.setScale(2, RoundingMode.HALF_UP)); // 2.36
数値フォーマット処理
DecimalFormatと組み合わせた数値整形例：
import java.math.BigDecimal;
import java.text.DecimalFormat;
public class FormatExample {
public static String formatCurrency(BigDecimal amount) {
DecimalFormat formatter = new DecimalFormat("###,##0.00");
return formatter.format(amount);
}
public static void main(String[] args) {
BigDecimal[] testValues = {
new BigDecimal("12345.678"),
new BigDecimal("0.995"),
new BigDecimal("1000")
};
for (BigDecimal value : testValues) {
System.out.println(formatCurrency(value));
}
}
}
通貨とパーセントのフォーマット
import java.math.BigDecimal;
import java.text.NumberFormat;
public class FinancialFormatting {
public static void main(String[] args) {
NumberFormat currencyFormat = NumberFormat.getCurrencyInstance();
NumberFormat percentFormat = NumberFormat.getPercentInstance();
percentFormat.setMinimumFractionDigits(2);
BigDecimal principal = new BigDecimal("1000000");
BigDecimal rate = new BigDecimal("0.025");
BigDecimal interest = principal.multiply(rate);
System.out.println("元金: " + currencyFormat.format(principal));
System.out.println("利率: " + percentFormat.format(rate));
System.out.println("利息: " + currencyFormat.format(interest));
}
}
注意すべき実装ポイント
初期化時の精度問題
// 推奨: 文字列からの初期化
BigDecimal correct = new BigDecimal("0.1");
// 非推奨: doubleからの初期化（精度問題の可能性）
BigDecimal problematic = new BigDecimal(0.1);
等値比較の注意点
BigDecimal num1 = new BigDecimal("2.0");
BigDecimal num2 = new BigDecimal("2.00");
System.out.println("equals比較: " + num1.equals(num2)); // false
System.out.println("compareTo比較: " + num1.compareTo(num2)); // 0
除算時の無限小数問題
BigDecimal numerator = new BigDecimal("1");
BigDecimal denominator = new BigDecimal("3");
// 例外発生（精度指定が必要）
// BigDecimal result = numerator.divide(denominator);
// 正しい使用方法
BigDecimal result = numerator.divide(denominator, 4, RoundingMode.HALF_UP);
文字列表現の違い
BigDecimal sciValue = new BigDecimal("1.23E5");
System.out.println("toString: " + sciValue.toString()); // 1.23E+5
System.out.println("toPlainString: " + sciValue.toPlainString()); // 123000
System.out.println("toEngineeringString: " + sciValue.toEngineeringString()); // 123E+3
null安全性とゼロ除算
BigDecimal valid = new BigDecimal("10");
BigDecimal invalid = null;
BigDecimal zero = new BigDecimal("0");
// NullPointerException発生
// valid.add(invalid);
// ArithmeticException発生
// valid.divide(zero);