Converting String to Decimal Number with 2 Decimal Places in Java

Problem Background and Common Errors

In Java development, converting strings formatted as "###.##" to floating-point numbers is a frequent requirement. Users typically expect that even when the input string is "123.00", the output should maintain the 123.00 format rather than being simplified to 123.0. However, many developers encounter precision loss issues when using Float.parseFloat() and DecimalFormat.

Error Case Analysis

Consider the following typical erroneous code:

String stringLitersOfPetrol = "010.00";
System.out.println("string liters of petrol putting in preferences is " + stringLitersOfPetrol);

Float litersOfPetrol = Float.parseFloat(stringLitersOfPetrol);
DecimalFormat df = new DecimalFormat("0.00");
df.setMaximumFractionDigits(2);

litersOfPetrol = Float.parseFloat(df.format(litersOfPetrol));
System.out.println("liters of petrol before putting in editor: " + litersOfPetrol);

This code outputs:

string liters of petrol putting in preferences is 010.00
liters of petrol before putting in editor: 10.0

The core issue lies in: although the DecimalFormat.format() method correctly formats the floating-point number as a string with two decimal places, the subsequent Float.parseFloat() call converts this string back to a floating-point number, causing the format information to be lost.

Correct Solution

The correct approach is to directly use the formatted string without parsing it back to a floating-point number:

import java.text.DecimalFormat;

String stringLitersOfPetrol = "123.00";
System.out.println("string liters of petrol putting in preferences is " + stringLitersOfPetrol);

Float litersOfPetrol = Float.parseFloat(stringLitersOfPetrol);
DecimalFormat df = new DecimalFormat("0.00");
df.setMaximumFractionDigits(2);

stringLitersOfPetrol = df.format(litersOfPetrol);
System.out.println("liters of petrol before putting in editor: " + stringLitersOfPetrol);

This code correctly outputs:

string liters of petrol putting in preferences is 123.00
liters of petrol before putting in editor: 123.00

Using BigDecimal to Avoid Precision Issues

For scenarios requiring high-precision calculations, it is recommended to use the BigDecimal class:

import java.math.BigDecimal;

String dennis = "0.00000008880000";
BigDecimal decimalValue = new BigDecimal(dennis);

// Format output
System.out.println(String.format("%.7f", decimalValue));
System.out.println(String.format("%.9f", decimalValue));
System.out.println(String.format("%.2f", decimalValue));

BigDecimal uses a decimal base to store values, avoiding the binary precision loss issues of floating-point numbers, making it particularly suitable for scenarios with strict precision requirements such as financial calculations.

Best Practices Summary

1. When only formatting for display is needed, use DecimalFormat.format() and directly use the returned string

2. For scenarios requiring subsequent calculations, prioritize using the BigDecimal class

3. Avoid unnecessary conversions between formatting and parsing

4. Understand the precision limitations of floating-point numbers and choose the appropriate numeric type for specific scenarios