比較 DecimalFormat 的格式、Locale 與捨入方式,使用 BigDecimal 避免金額精度誤判。
適用:JDK 25 標準函式庫;本文範例以 JDK 25 原生編譯並執行,核對下列輸出。
當 API、報表或畫面需要固定的小數位數與千分位,可以用 DecimalFormat 控制呈現。要讓不同電腦產生相同結果,除了 pattern,也需要明確指定 Locale 與捨入方式。
使用情境與適用環境
本文示例以 OpenJDK 25.0.4.1 編譯並執行,僅使用 Java 標準函式庫。選用 Locale.US,讓小數點使用 .、分組符號使用 ,。
格式化的結果是字串。資料本身的計算與畫面的輸出格式是兩個步驟,顯示為兩位小數不代表原始數值已改變。
常用格式符號
| 符號 | 意義 | 示例 |
|---|---|---|
0 | 位數不足時補零 | 000000.000:123.78 → 000123.780 |
# | 可省略的數字位置 | #,##0.###:123456.789 → 123,456.789 |
. | pattern 中的小數分隔位置 | 顯示符號由 Locale 決定 |
, | pattern 中的分組位置 | #,##0.00:1234 → 1,234.00 |
% | 格式化前將數值乘以 100,附上百分比符號 | 0.00%:0.125 → 12.50% |
完整可執行範例
存為 DecimalFormatDemo.java:
import java.math.BigDecimal;
import java.math.RoundingMode;
import java.text.DecimalFormat;
import java.text.DecimalFormatSymbols;
import java.util.Locale;
public class DecimalFormatDemo {
private static DecimalFormat formatter(String pattern, RoundingMode rounding) {
DecimalFormat format = new DecimalFormat(
pattern, DecimalFormatSymbols.getInstance(Locale.US));
format.setRoundingMode(rounding);
return format;
}
public static void main(String[] args) {
System.out.println(formatter("#,##0.###", RoundingMode.HALF_EVEN)
.format(new BigDecimal("123456.789")));
System.out.println(formatter("000000.000", RoundingMode.HALF_EVEN)
.format(new BigDecimal("123.78")));
System.out.println(formatter("0.00%", RoundingMode.HALF_EVEN)
.format(new BigDecimal("0.125")));
System.out.println(formatter("0.00", RoundingMode.HALF_EVEN)
.format(new BigDecimal("2.345")));
System.out.println(formatter("0.00", RoundingMode.HALF_UP)
.format(new BigDecimal("2.345")));
}
}執行:
javac -encoding UTF-8 DecimalFormatDemo.java
java DecimalFormatDemo預期結果:
123,456.789
000123.780
12.50%
2.34
2.35最後兩行使用同一個精確十進位值 2.345。在兩位小數的中點,HALF_EVEN 選擇最後保留位為偶數的 2.34;HALF_UP 則得到 2.35。DecimalFormat 預設使用 HALF_EVEN,因此要明確選擇符合需求的規則。
為什麼使用 BigDecimal 的字串建構子
new BigDecimal("2.345") 保留字串表示的十進位值。double 是二進位浮點數,像 2.345 這類值可能無法精確表示;將它先轉成 double 再建構 BigDecimal,測試就不再是相同的精確中點。
本文為了展示確定的捨入結果,使用字串建構 BigDecimal。格式化只處理輸出,計算時仍要在適當位置決定精度與捨入規則。
限制與常見錯誤
Locale.US是本文重現結果的選擇;多語系畫面應依目標使用者的 Locale 呈現。DecimalFormat不是執行緒安全的物件,不要把單一例項放進多執行緒共用且沒有同步的服務。- 數值
0.125使用%會變成12.50%;已經以12.5表達百分比的資料,不能再套用同樣轉換。 - 把
$寫進 pattern 只會加上字元,不會選擇貨幣或進行匯率轉換。 - 若需要處理輸入字串,
parse()的規則與回傳型別也必須另外確認,不能只靠輸出格式推斷。
重點回顧
固定 Locale、使用明確的十進位資料與捨入方式,範例才能在不同環境中重現。選好 pattern 之後,再確認百分比、分組符號與多執行緒使用方式是否符合需求。
- Java SE 21:DecimalFormat(歷史參考)
- Java SE 21:BigDecimal(歷史參考)
- Java SE 21:RoundingMode(歷史參考)
- Oracle Java Tutorials:Customizing Formats
修訂確認
原有完整範例保留;本文是可控的學習情境,實際系統還需依資料庫延遲與併發負載調整。查核不代表任何引數能直接適用所有 production 服務。
系列導覽
00 環境 · 01 第一支程式 · 02 型別 · 03 變數 · 04 物件導向 · 多型範例
冒險者留言
comments powered by Disqus