string.format 是 java 中通过占位符格式化字符串的核心方法,需掌握 %d/%f/%s 等占位符规则、日期需先用 simpledateformat 或 datetimeformatter 转字符串、数值支持精度与千分位、对齐与索引增强排版,并注意 null 处理、locale 设置及性能优化。

String.format 是 Java 中格式化字符串的常用方法,它用占位符代替变量,再按规则填入数值或日期,让输出更规范、易读。关键在于掌握占位符语法和对应的数据类型转换规则。
日期格式化:用 SimpleDateFormat 的模式串配合 format
String.format 本身不直接支持日期(如 Date 或 LocalDateTime)的复杂格式化,需先转成字符串。推荐做法是用 SimpleDateFormat(旧 API)或 DateTimeFormatter(Java 8+ 推荐)预处理,再交给 String.format 拼接:
- 对于 Date 对象,先用 SimpleDateFormat 格式化:
String dateStr = new SimpleDateFormat("yyyy-MM-dd HH:mm").format(new Date());
String msg = String.format("当前时间:%s", dateStr); - 对于 LocalDateTime,用 DateTimeFormatter 更安全:
LocalDateTime now = LocalDateTime.now();
String timeStr = now.format(DateTimeFormatter.ofPattern("MM/dd HH:mm:ss"));
String output = String.format("登录时间:%s", timeStr); - 注意:不要对 Date 类型直接用 %t 开头的格式符(如 %tY),除非传入的是 Calendar 或 long 时间戳,且容易出错,新手建议统一先转字符串。
数值格式化:用 %d、%f、%e 等控制整数、小数与科学计数
数值是最常格式化的类型,占位符决定显示方式和精度:
-
%d:十进制整数,适用于 int、long;
String s1 = String.format("数量:%d 件", 123); // 输出:数量:123 件 -
%f:浮点数,默认保留6位小数;可指定精度,如 %.2f 表示保留两位:
String s2 = String.format("价格:¥%.2f", 99.8); // 输出:价格:¥99.80 -
%,d 和 %,.2f:加入千位分隔符,提升可读性:
String s3 = String.format("总金额:%,d 元", 1234567); // 输出:总金额:1,234,567 元
String s4 = String.format("平均值:%,.3f", 12345.6789); // 输出:平均值:12,345.679 - %x / %X:十六进制(小写/大写),适合调试或状态码显示。
组合输出与对齐:用宽度、补零、左对齐增强排版效果
在日志、表格或命令行工具中,对齐能让信息更清晰:
-
%5d:最小宽度为 5,右对齐,不足补空格;
String s = String.format("|%5d|", 42); // 输出:| 42| -
%05d:最小宽度 5,不足补零(仅对数字有效);
String s = String.format("%05d", 7); // 输出:00007 -
%-10s:字符串左对齐,宽度 10;
String s = String.format("|%-10s|", "abc"); // 输出:|abc | - 多个参数按顺序填入,位置可用索引控制(如 %1$s %2$d),适合复用或调整顺序。
常见坑与建议
新手容易卡在这几个地方:
- 传入 null 到 %s 会输出字符串 "null",不是报错;但传 null 给 %d 会抛 NullPointerException。
- Date 类型不能直接用 %tF(年-月-日),除非包装成 Calendar 或用 getTime() 转成 long 后用 %tF —— 但不如先格式化成字符串直观可靠。
- 中文环境下注意默认区域设置可能影响小数点、千分位符号,必要时显式指定 Locale:
String.format(Locale.US, "%.2f", 3.1415) // 确保用英文小数点 - 大量拼接建议改用 StringBuilder 或 MessageFormat;String.format 每次都新建对象,频繁调用有开销。










