讲师中心 微信公众号
AI工具推荐 视频效率加速

Java String.format方法详解_控制数字、日期与文本的格式化占位符

轻婷同学_5837

轻婷同学_5837

发布时间:2026-02-18 11:22:39

|

999人浏览过

|

来源于php中文网

原创

String.format无法直接实现数字补零兼容负数和小数截断,需手动处理:负数补零用符号+绝对值格式化,截断小数需先Math.floor(x*100)/100.0;日期格式化应优先用DateTimeFormatter;需显式指定Locale防乱码;性能敏感场景建议用StringBuilder或SLF4J占位符。

java string.format方法详解_控制数字、日期与文本的格式化占位符

String.format 里数字补零和小数截断怎么写才不丢精度

用 String.format 格式化数字时,%05d 看似能补零,但遇到负数会把负号挤到最左,变成 -0012;而 %.2f 表面截两位小数,实际是四舍五入,不是截断——比如 1.239 变成 1.24,但业务要的是 1.23。

真正要截断而非四舍五入,得先用 Math.floor(x * 100) / 100.0 手动处理,再格式化;补零若需兼容负数且保持宽度(如总宽 5,负数显示为 -012),不能只靠 %05d,得拆成符号 + 绝对值 + 补零拼接:

int x = -12;
String s = (x < 0 ? "-" : "") + String.format("%0" + (Math.abs(x) + "").length() + "d", Math.abs(x));
  • %05d 对负数无效:它补的是整个字段宽度,负号占一位,剩下才补零
  • %.2f 是舍入,不是截断;Java 没有原生“截断格式符”
  • 浮点数用 double 格式化易出现 0.1 + 0.2 = 0.30000000000000004 这类问题,货币类场景必须用 BigDecimal 配合 setScale

日期格式化用 SimpleDateFormat 还是 String.format

String.format 不支持日期类型直接格式化——传 Date 或 LocalDateTime 会调用 toString(),输出默认字符串,不是你想要的 yyyy-MM-dd HH:mm。真要格式化日期,必须用 SimpleDateFormat(旧 API)或 DateTimeFormatter(Java 8+ 推荐)。

虽然 String.format 支持 %t 系列转换符(如 %tY-%tm-%td),但它只接受 long 时间戳或实现了 java.util.Formattable 的对象(Date 实现了,但 LocalDateTime 没有),所以:

Java注释规范Skills
Java注释规范Skills

当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。

下载

立即学习“Java免费学习笔记(深入)”;

  • String.format("%tY-%tm-%td", new Date()) 可行,但可读性差、难维护
  • String.format("%tY-%tm-%td", LocalDateTime.now()) 直接抛 IllegalFormatConversionException
  • SimpleDateFormat 非线程安全,多线程下必须每次新建或用 ThreadLocal 包裹
  • Java 8+ 强烈优先用 DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm"),不可变、线程安全

中文乱码、空格截断与 locale 的隐式影响

String.format 默认使用 JVM 启动时的 Locale,这会影响千位分隔符、小数点符号、甚至月份/星期名称。比如在中文环境用 %,d 格式化 1000000,得到 1,000,000(英文逗号),但某些 locale 会用 1.000.000 或 1 000 000;更隐蔽的是,%s 输出字符串时,如果源字符串含中文,而目标控制台或日志系统编码不是 UTF-8,就会显示为 ???——这不是 String.format 的错,但它不负责编码转换。

  • 显式指定 Locale 可控: String.format(Locale.US, "%,d", 1000000)
  • 避免依赖默认 locale,尤其做国际化服务时
  • 中文文本被截断?检查是否用了 %-10.5s 这类带精度限制的格式符——中文字符在 Java 中是 1 个 char,但 .5s 会按 char 数截,5 个 char 可能只有 2–3 个汉字
  • 日志中看到方块或问号,先确认输出端(IDE 控制台、Linux terminal、Logback 配置)的字符集是否设为 UTF-8

性能敏感场景下,String.format 和 StringBuilder 拼接怎么选

单纯拼接几个变量,String.format 比 StringBuilder.append 慢 3–5 倍,因为要解析格式串、匹配占位符、做类型检查、再反射调用对应格式化逻辑。JIT 编译后差距缩小,但高频日志(如每毫秒一条)仍建议直拼。

  • 日志语句中写 log.debug("user={} balance={}", uid, balance)(SLF4J)比 log.debug(String.format("user=%s balance=%.2f", uid, balance)) 更快且延迟低
  • String.format 的缓存机制仅限于编译期常量格式串,运行时拼出来的格式串无法复用解析结果
  • 如果格式串本身来自配置(如数据库查出的模板),必须用 String.format,但要注意预编译校验——非法格式符会导致运行时报 UnknownFormatConversionException
  • Android 上 String.format 开销更大,官方文档明确建议用 Resources.getString(int, Object...) 替代

格式化这件事,看着简单,实则每一步都卡在类型、locale、编码、精度四个维度上。最容易被忽略的,是把 String.format 当万能胶水——它不处理编码,不保证线程安全,不支持局部截断,也不该出现在性能热区。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

6699

2023.08.02

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6164

2023.10.24

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1769

2023.07.31

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1211

2024.06.27

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1798

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2824

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6164

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

5929

2023.11.24

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

100

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn