DecimalFormat 是 Java 中用于按自定义模式格式化数字的核心工具,依赖模式字符串(如 "#,##0.00")和显式设置的 RoundingMode(默认 HALF_EVEN)控制输出样式,需注意线程不安全及本地化适配问题。

DecimalFormat 是 Java 中最常用、最灵活的数字格式化工具,专用于将数字(double、long、BigDecimal 等)按自定义模式转为字符串,比如保留两位小数、千位分隔、百分比显示、货币样式等。它不负责四舍五入逻辑本身,而是依赖 RoundingMode 配合使用,核心在于“模式字符串”的写法。
用模式字符串精准控制输出样式
DecimalFormat 的行为由一个模式字符串(pattern)驱动,例如 "#,##0.00" 或 "0.##"。每个符号有明确含义:
-
0:占位符,必须显示数字,不足补 0(如5格式化为"05") -
#:可选数字,不补 0(如5格式化为"5") -
,:千位分隔符(自动适配本地化,中文环境是“,”,英文也是“,”) -
.:小数点(同样本地化感知) -
%:表示百分比——数值会 ×100 后加 % 符号(如0.123→"12.3%") -
¤:货币符号占位符(配合setCurrency()使用)
示例:new DecimalFormat("#,##0.00") → 12345.6 变成 "12,345.60"new DecimalFormat("0.##") → 12.345 变成 "12.34"(非四舍五入,是截断?错!其实是按 RoundingMode 四舍五入,但默认是 HALF_EVEN)
四舍五入规则不能只靠模式,要显式设置 RoundingMode
DecimalFormat 默认使用 RoundingMode.HALF_EVEN(银行家舍入),不是简单四舍五入。如果你需要明确行为,必须调用 setRoundingMode():
立即学习“Java免费学习笔记(深入)”;
-
HALF_UP:传统四舍五入(1.5 → 2,-1.5 → -2) -
HALF_DOWN:五舍六入(1.5 → 1) -
DOWN:直接截断(1.99 → 1) -
UP:向上取整(1.1 → 2)
代码示例:
DecimalFormat df = new DecimalFormat("0.00");
df.setRoundingMode(RoundingMode.HALF_UP);
String s = df.format(1.255); // → "1.26"
注意线程安全和本地化问题
DecimalFormat 不是线程安全的,多线程共用同一个实例可能出错。推荐做法:
- 每次使用新建实例(轻量,开销不大)
- 或用
ThreadLocal缓存 - 避免在 Spring Bean 中直接注入单例 DecimalFormat
本地化方面:默认使用当前 Locale,但可显式指定,比如显示德语风格千分位(空格)和逗号小数点:
DecimalFormat df = (DecimalFormat) DecimalFormat.getInstance(Locale.GERMAN);
df.applyPattern("#,##0.00"); // 实际会变成 "# ##0,00"
替代方案:NumberFormat 和 BigDecimal.setScale 更适合业务计算
如果目标是“先精确计算再格式化”,别只依赖 DecimalFormat 做舍入:
- 计算过程建议用
BigDecimal+setScale(scale, RoundingMode)显式控制精度 - 再用 DecimalFormat 或
NumberFormat(更面向国际化的抽象类)做最终展示 - 避免对 double 做高精度格式化(如
0.1 + 0.2≠0.3),优先转成 BigDecimal
例如金额处理:
BigDecimal bd = new BigDecimal("123.456").setScale(2, RoundingMode.HALF_UP);
String display = NumberFormat.getCurrencyInstance(Locale.CHINA).format(bd); // ¥123.46
基本上就这些。DecimalFormat 强大但细节多,关键是理解模式语法 + rounding mode + 线程/本地化约束。用对了,格式化又准又稳。










