6
头图

从 Java 5.0 开始,String 类新增了一个强大的字符串格式化方法 format()。这个方法到现在用的人还是不多,实在是一种浪费。本文带你快速过一遍这个方法的功能,将来你要用到格式化文本的时候,可能就不需要再借用第三方类库或自己去实现了。

首先看一个简单例子:

String formatted = String.format("%s今年%d岁。", "小李", 30); // "小李今年30岁。"

不用我多解释,你也可以看出:

  1. 这个方法第一个参数是格式串,后面的参数都是格式串的参数,用于替换格式串中的占位符。
  2. 占位符以 "%x" 的形式表示,不同的参数类型要用不同的字母。后面会具体介绍。
  3. String.format() 返回值类型为字符串,也就是格式化的结果。

一、占位符类型

占位符 "%" 后面的字母决定了其接受的实际参数的类型。占位符类型有下面几种:

字母适用参数类型说明
%a浮点数以16进制输出浮点数
%b / %B任意值如果参数为 null 则输出 false,否则输出 true
%c / %C字符或整数输出对应的 Unicode 字符
%d整数对整数进行格式化输出
%e / %E浮点数以科学记数法输出浮点数
%f浮点数对浮点数进行格式化输出
%g / %G浮点数以条件来决定是否以科学记数法方式输出浮点数
%h / %H任意值以 16 进制输出参数的 hashCode() 返回值
%o整数以8进制输出整数
%s / %S字符串对字符串进行格式化输出
%t日期时间对日期时间进行格式化输出
%x / %X整数以16进制输出整数
%n换行符
%%百分号本身

大写字母表示输出的字母都为大写。

我们平常用的最多的就是 %s%d%f,偶尔会用到 %t。本文篇幅有限,仅介绍这四种,剩下的请自行阅读 API 文档

二、字符串和整数格式化

这里直接给出例子来说明:

// 补齐空格并右对齐:
String.format("%10s, world", "Hello");     // 输出 "     Hello, world"
String.format("%8d", 123);                 // 输出 "     123"

// 补齐空格并左对齐:
String.format("%-10s, world", "Hello");    // 输出 "Hello     , world"
String.format("%-8d", 123);                // 输出 "123     "

// 补齐 0 并对齐(仅对数字有效)
String.format("%08d", 123);                // 输出 "00000123"
String.format("%-08d", 123);               // 错误!不允许在右边补齐 0

// 输出最多N个字符
String.format("%.5s", "Hello, world");       // 输出 "Hello"
String.format("%.5s...", "Hello, world");    // 输出 "Hello..."
String.format("%10.5s...", "Hello, world");  // 输出 "     Hello..."

// 输出逗号分隔数字
String.format("%,d", 1234567);               // 输出 "1,234,567"

三、日期格式化

这个就稍微复杂点,但如果你要在字符串中对文本数字和日期进行混排的话,只调一个方法应该比结合 DateFormatNumberFormat 一起用要方便点。

首先补充一个知识,就是占位符可以指定某个位置的参数,格式为 %n$。例如 %2$d 表示第二个整形参数。注意这里的 n 是 1 开始而不是 0 开始。

格式化日期的时候,需要多个占位符指向同一个参数(以避免同一个参数重复几遍),同时因为 "t" 表示日期时间,所以完整的格式为 %n$tX,其中 X 表示取时间中的哪一部分。X 的可选值例如:

Y=年;m=月;d=日;H=时;M=分;S=秒;L=毫秒;A=星期几(名称);B=月份名称;

还有其他的字母,具体请参考 API 文档。下面是一个例子:

// 输出格式为 “Now is         15:04:52, 星期日”
// 注意 "%1$10tH" 中的 10 同样表示空格补齐 10 位并右对齐
String.format("Now is %1$10tH:%1$tM:%1$tS, %1$tA", new Date())

捏造的信仰
2.8k 声望272 粉丝

Java 开发人员