在Java开发中，“格式化”几乎无处不在——从拼接用户友好的提示信息，到处理财务数字的千位分隔符，再到将日期时间按特定模式输出。良好的格式化不仅能提升用户体验，还能避免因区域或数据类型转换引发的程序错误。本文系统梳理Java中各种格式化手段，并提供可直接上手的代码示例。

一、字符串格式化：printf()、String.format() 与 Formatter

1.1 System.out.printf() —— C语言风格的直接输出

Java保留了C语言的printf风格，用于向控制台输出格式化字符串：

java

复制

下载

System.out.printf("整数：%d，浮点数：%.2f，字符串：%s%n", 42, 3.14159, "Hello");
// 输出：整数：42，浮点数：3.14，字符串：Hello

• %d：十进制整数

• %f：浮点数（可控制小数位数，如%.2f）

• %s：字符串

• %n：平台无关的换行符

1.2 String.format() —— 返回格式化后的字符串

与printf参数相同，但返回String对象，便于日志记录或界面显示：

java

复制

下载

String msg = String.format("用户 %s 在 %tF 登录成功", "张三", new Date());
System.out.println(msg); // 用户 张三 在 2025-06-09 登录成功

%tF是日期格式化简写，等价于%tY-%tm-%td。

1.3 java.util.Formatter —— 更灵活的格式化器

Formatter可以写入StringBuilder、文件等目的地：

java

复制

下载

StringBuilder sb = new StringBuilder();
Formatter formatter = new Formatter(sb);
formatter.format("今天是 %1$tY年%1$tm月%1$td日", Calendar.getInstance());
System.out.println(sb); // 今天是 2025年06月09日
formatter.close();

格式说明符完整语法：%[参数索引$][标志][宽度][.精度]转换符

• 1$：引用第一个参数

• -：左对齐

• +：显示正负号

• 0：用零填充

java

复制

下载

System.out.printf("%-10s %05d%n", "编号", 12); // 编号       00012

二、数字格式化：DecimalFormat 与 NumberFormat

2.1 千位分隔符、小数位数与货币

NumberFormat提供了区域感知的工厂方法：

java

复制

下载

// 普通数字（带千位分隔符）
NumberFormat nf = NumberFormat.getNumberInstance(Locale.CHINA);
System.out.println(nf.format(1234567.89)); // 1,234,567.89

// 货币格式
NumberFormat cf = NumberFormat.getCurrencyInstance(Locale.US);
System.out.println(cf.format(1234.56)); // $1,234.56

// 百分比（自动乘以100）
NumberFormat pf = NumberFormat.getPercentInstance();
pf.setMinimumFractionDigits(2);
System.out.println(pf.format(0.1234)); // 12.34%

2.2 自定义模式 —— DecimalFormat

当需要完全控制格式（如保留两位小数、科学计数法、填充字符）时，使用DecimalFormat：

java

复制

下载

DecimalFormat df = new DecimalFormat("###,###.##");
System.out.println(df.format(1234567.891)); // 1,234,567.89

// 强制显示正负号，不足位补零
df = new DecimalFormat("+0000.00;-0000.00");
System.out.println(df.format(25));   // +0025.00
System.out.println(df.format(-3.2)); // -0003.20

// 科学计数法
df = new DecimalFormat("0.###E0");
System.out.println(df.format(12345)); // 1.234E4

注意：DecimalFormat不是线程安全的，多线程下需用ThreadLocal或同步。

三、日期时间格式化：从 SimpleDateFormat 到 DateTimeFormatter

3.1 旧版 SimpleDateFormat（线程不安全，不推荐）

java

复制

下载

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
Date now = new Date();
String formatted = sdf.format(now);
System.out.println(formatted);

严重缺陷：SimpleDateFormat不是线程安全的，若多个线程共用同一实例，可能抛出NumberFormatException或产生错误结果。在Servlet、Spring单例Bean中尤其危险。

3.2 新版 DateTimeFormatter（Java 8+，推荐）

配合java.time包使用，完全不可变且线程安全：

java

复制

下载

LocalDateTime now = LocalDateTime.now();

// 预定义标准格式
DateTimeFormatter isoFormatter = DateTimeFormatter.ISO_LOCAL_DATE_TIME;
System.out.println(isoFormatter.format(now)); // 2025-06-09T14:30:15.123

// 自定义模式
DateTimeFormatter customFormatter = DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH:mm:ss");
String formatted = now.format(customFormatter); // 更简洁的调用方式
System.out.println(formatted); // 2025年06月09日 14:30:15

// 解析字符串回日期对象
LocalDateTime parsed = LocalDateTime.parse("2025-06-09 14:30:15", 
    DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));

常用模式字母：

• yyyy：四位年份

• MM：月份（01-12）

• dd：日

• HH：24小时制，hh：12小时制

• mm：分钟，ss：秒

• SSS：毫秒

• a：上午/下午标记

3.3 时区格式化

java

复制

下载

ZonedDateTime zdt = ZonedDateTime.now(ZoneId.of("America/New_York"));
DateTimeFormatter fmt = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss z");
System.out.println(zdt.format(fmt)); // 2025-06-09 02:30:15 EDT

四、消息格式化：MessageFormat 处理模板占位符

当需要将参数动态插入到包含大括号占位符的模板中，MessageFormat比字符串拼接更优雅：

java

复制

下载

String template = "用户 {0} 在 {1,date,yyyy-MM-dd} 执行了 {2} 操作。";
String result = MessageFormat.format(template, "admin", new Date(), "删除");
System.out.println(result); // 用户 admin 在 2025-06-09 执行了 删除 操作。

占位符语法：{索引[,类型[,风格]]}，类型可以是number、date、time、choice。

高级例子（复数/选择格式）：

java

复制

下载

String choiceTemplate = "找到 {0,choice,0#0个文件|1#1个文件|1<{0,number,integer}个文件}。";
System.out.println(MessageFormat.format(choiceTemplate, 0)); // 找到 0个文件。
System.out.println(MessageFormat.format(choiceTemplate, 5)); // 找到 5个文件。

注意：MessageFormat也不是线程安全的；每次调用都应创建新实例或使用同步。

五、格式化最佳实践与陷阱

5.1 性能注意事项

• 频繁调用String.format()会产生临时Formatter对象和StringBuilder，在高吞吐场景（如循环内）应使用StringBuilder手动拼接或复用Formatter实例。

• MessageFormat内部使用正则解析模板，相对较重；建议缓存模板字符串，避免每调用一次都重新解析。

5.2 线程安全总结

类	线程安全	备注
String.format()	✅ 是	每次返回新字符串，无状态
DateTimeFormatter	✅ 是	不可变，推荐复用
DecimalFormat	❌ 否	内部有缓存可变状态
SimpleDateFormat	❌ 否	日历字段被修改，极危险
MessageFormat	❌ 否	模式解析状态可变

5.3 区域（Locale）问题

始终明确指定Locale，否则会使用默认区域导致跨环境格式不一致：

java

复制

下载

// 错误：依赖默认Locale，服务器可能返回奇怪结果
String bad = String.format("价格：%.2f", 1234.5);

// 正确：使用Locale.US保证小数点始终为'.'
String good = String.format(Locale.US, "价格：%.2f", 1234.5);

对于DecimalFormat，建议通过DecimalFormatSymbols设置特定区域符号。

5.4 处理 null 值

直接格式化null会导致字符串输出"null"或抛出异常（取决于API）。建议使用Objects.toString(obj, "")或三元运算符预处理。

java

复制

下载

String value = String.format("内容：%s", Objects.toString(someObj, "（空）"));

六、完整示例：综合格式化输出

下面代码演示了在一个日志记录场景中如何组合使用多种格式化器：

java

复制

下载

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.text.NumberFormat;
import java.util.Locale;

public class FormatDemo {
    private static final DateTimeFormatter LOG_DTF = 
        DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSS");
    
    public static void main(String[] args) {
        // 1. 时间戳
        String timestamp = LocalDateTime.now().format(LOG_DTF);
        
        // 2. 格式化金额
        NumberFormat currencyFmt = NumberFormat.getCurrencyInstance(Locale.CHINA);
        String amount = currencyFmt.format(123456.78);
        
        // 3. 构造日志消息
        String log = String.format("[%s] 订单金额：%s，状态：%s", 
            timestamp, amount, "支付成功");
        
        System.out.println(log);
        // 输出类似：[2025-06-09 14:30:15.123] 订单金额：￥123,456.78，状态：支付成功
    }
}

结语

Java提供了从简单到复杂的多层次格式化工具。选择时遵循原则：

• 字符串拼接 → 简单场景用+（编译器优化后性能不差）；需要模板时用String.format。

• 数字/货币/百分比 → NumberFormat工厂方法，或DecimalFormat自定义模式。

• 日期时间 → 强制使用java.time + DateTimeFormatter，彻底远离SimpleDateFormat。

• 带参数模板 → MessageFormat支持更强大的占位符和选择格式。

正确且高效的格式化能让你的代码更专业、更健壮。希望本文成为你日常开发中随手查阅的格式化手册。这里推荐一个实用的在线工具（JAVA格式化,JAVA代码美化-站长工具箱）