一、前言

String.format() 作为文本处理工具，为我们提供强大而丰富的字符串格式化功能，为了不止步于简单调用 String.format("Hello %s", "John");，下面将笔记整理并记录下来。

其实各个语言的字符串格式化方法都是相通的，你可以在其中找到你熟悉的语言的影子，如C语言等。

二、重载方法

↓CloseCode↓

// 使用当前本地区域对象（Locale.getDefault()）格式化字符串String String.format(String fmt, Object... args);// 自定义本地区域对象格式化字符串String String.format(Locale locale, String fmt, Object... args);

三、占位符

占位符完整格式为： %[index$][标识]*[最小宽度][.精度]转换符 。

针对不同数据类型的格式化，占位符的格式将有所裁剪。

%：占位符的起始字符，若要在占位符内部使用%，则需要写成 %% 。[index$]：位置索引从1开始计算，用于指定对索引相应的实参进行格式化并替换掉该占位符。[标识]：用于增强格式化能力，可同时使用多个[标识]，但某些标识是不能同时使用的。[最小宽度]：用于设置格式化后的字符串最小长度，若使用[最小宽度]而无设置[标识]，那么当字符串长度小于最小宽度时，则以左边补空格的方式凑够最小宽度。[.精度]：对于浮点数类型格式化使用，设置保留小数点后多少位。转换符：用于指定格式化的样式，和限制对应入参的数据类型。四、对字符、字符串进行格式化

占位符格式为： %[index$][标识][最小宽度]转换符

示例——将"hello"格式化为" hello"

↓CloseCode↓

String raw = "hello";String str = String.format("%1$7s", raw);// 简化String str = String.format("%7s", raw);

示例——将"hello"格式化为"hello "

↓CloseCode↓

String raw = "hello";String str = String.format("%1$-7s", raw);// 简化String str = String.format("%-7s", raw);

可用标识：默认：在最小宽度内右对齐，左边用空格补上；要是超过了最小宽度，那么就无效，正常显示即可。-：在最小宽度内左对齐，右边用空格补上；要是超过了最小宽度，那么就无效，正常显示即可。可用转换符：s：字符串类型。c：字符类型，实参必须为char或int、short等可转换为char类型的数据类型，否则抛IllegalFormatConversionException异常。b：布尔类型，只要实参为非false的布尔类型，均格式化为字符串true，否则为字符串false。n：平台独立的换行符（与通过 System.getProperty("line.separator") 是一样的）五、对整数进行格式化

占位符格式为： %[index$][标识]*[最小宽度]转换符

示例——将1显示为0001

↓CloseCode↓

int num = 1;String str = String.format("%04d", num);

示例——将-1000显示为(1,000)

↓CloseCode↓

int num = -1000;String str = String.format("%(,d", num);

可用标识：-：在最小宽度内左对齐,不可以与0标识一起使用。0：若内容长度不足最小宽度，则在左边用0来填充。#：对8进制和16进制加上前导，8进制前添加一个0,16进制前添加0x。+：结果总包含一个+或-号。空格：正数前加空格，负数前加-号。,：只用与十进制，每3位数字间用,分隔。(：若结果为负数，则用括号括住，且不显示符号。可用转换符：b：布尔类型，只要实参为非false的布尔类型，均格式化为字符串true，否则为字符串false。d：整数类型（十进制）。x：整数类型（十六进制）。o：整数类型（八进制）n：平台独立的换行符, 也可通过System.getProperty("line.separator")获取六、对浮点数进行格式化

占位符格式为： %[index$][标识]*[最小宽度][.精度]转换符

示例：

↓CloseCode↓

double num = 123.4567899;System.out.print(String.format("%f %n", num)); // 123.456790 System.out.print(String.format("%a %n", num)); // 0x1.edd3c0bb46929p6 System.out.print(String.format("%g %n", num)); // 123.457

可用标识：-：在最小宽度内左对齐,不可以与0标识一起使用。0：若内容长度不足最小宽度，则在左边用0来填充。#：对8进制和16进制，8进制前添加一个0，16进制前添加0x。+：结果总包含一个+或-号。空格：正数前加空格，负数前加-号。,：只用与十进制，每3位数字间用,分隔。(：若结果为负数，则用括号括住，且不显示符号。可用转换符：b：布尔类型，只要实参为非false的布尔类型，均格式化为字符串true，否则为字符串false。n：平台独立的换行符, 也可通过System.getProperty("line.separator")获取。f：浮点数型（十进制）。显示9位有效数字，且会进行四舍五入。如99.99。a：浮点数型（十六进制）。e：指数类型。如9.38e+5。g：浮点数型（比%f，%a长度短些，显示6位有效数字，且会进行四舍五入）七、对日期时间进行格式化

占位符格式为： %[index$]t转换符

示例：

↓CloseCode↓

Date now = new Date();String str = String.format("%tF", now); // 2014-10-12

可用转换符1.日期的转换符c：星期六 十月 27 14:21:20 CST 2007F：2007-10-27D：10/27/07r：02:25:51 下午T：14:28:16R：14:28b：月份简称B：月份全称a：星期简称A：星期全称C：年前两位（不足两位补零）y：年后两位（不足两位补零）j：当年的第几天m：月份（不足两位补零）d：日期（不足两位补零）e：日期（不足两位不补零）2.时间的转换符H：24小时制的小时（不足两位补零）k：24小时制的小时（不足两位不补零）I：12小时制的小时（不足两位补零）i：12小时制的小时（不足两位不补零）M：分钟（不足两位补零）S：秒（不足两位补零）L：毫秒（不足三位补零）N：毫秒（不足9位补零）p：小写字母的上午或下午标记，如中文为“下午”，英文为pmz：相对于GMT的时区偏移量，如+0800Z：时区缩写，如CSTs：自1970-1-1 00:00:00起经过的秒数Q：自1970-1-1 00:00:00起经过的豪秒八、其他转换符

<，用于格式化前一个转换符所描述的参数。

示例：

↓CloseCode↓

int num = 1000;String str = String.format("%d %<,d", num);// 结果"1000 1,000

1.常规类型、字符类型和数值类型的格式说明符的语法如下：

%[argument_index$][flags][width][.precision]conversion

可选的 argument_index 是一个十进制整数，用于表明参数在参数列表中的位置。第一个参数由 "1"引用，第二个参数由"2"引用，第二个参数由"2" 引用，依此类推。可选的 flags 是修改输出格式的字符集。有效标志的集合取决于转换类型。可选 width 是一个非负十进制整数，表明要向输出中写入的最少字符数。可选 precision 是一个非负十进制整数，通常用来限制字符数。特定行为取决于转换类型。必须的 conversion 是一个表明应该如何格式化参数的字符。给定参数的有效转换集合取决于参数的数据类型。2.用来表示日期和时间类型的格式说明符的语法如下:

%[argument_index$][flags][width]conversion

可选的 argument_index、flags 和 width 的定义同上。必须的 conversion 是一个由两字符组成的序列。第一个字符是 't' 或 'T'。第二个字符表明所使用的格式。这些字符类似于但不完全等同于那些由 GNU date 和 POSIX strftime(3c) 定义的字符。3.与参数不对应的格式说明符的语法如下：

%[flags][width]conversion

可选 flags 和 width 的定义同上。必须的 conversion 是一个表明要在输出中所插内容的字符。转换

转换可分为以下几类：

常规：可应用于任何参数类型字符：可应用于表示 Unicode 字符的基本类型：char、Character、byte、Byte、short 和 Short。

当 Character.isValidCodePoint(int) 返回 true 时，可将此转换应用于 int 和 Integer 类型数值：整数：可应用于 Java 的整数类型：byte、Byte、short、Short、int、Integer、long、Long 和 BigInteger浮点：可用于 Java 的浮点类型：float、Float、double、Double 和 BigDecimal日期/时间：可应用于 Java 的、能够对日期或时间进行编码的类型：long、Long、Calendar 和 Date。百分比：产生字面值 '%' ('\u0025')行分隔符：产生特定于平台的行分隔符

格式化表达式：%[零个或多个标志][最小字段宽度][精度][修改符]格式码

注意：[]方括号表示可选参数

常规类型的格式化

String类的format()方法用于创建格式化的字符串以及连接多个字符串对象。熟悉C语言的同学应该记得C语言的sprintf()方法，两者有类似之处。

format()方法有两种重载形式。

format(String format, Object... args)：新字符串使用本地语言环境，制定字符串格式和参数生成格式化的新字符串。

format(Locale locale, String format, Object... args)：使用指定的语言环境，制定字符串格式和参数生成格式化的字符串。

转换符

显示不同转换符实现不同数据类型到字符串的转换，如图所示。

转换符 说明 示例 %s 字符串类型 "mingrisoft" %c 字符类型 'm' %b 布尔类型 true %d 整数类型（十进制） 99 %x 整数类型（十六进制） FF %o 整数类型（八进制） 77 %f 浮点类型 99.99 %a 十六进制浮点类型 FF.35AE %e 指数类型 9.38e+5 %g 通用浮点类型（f和e类型中较短的） %h 散列码 %% 百分比类型 ％ %n 换行符 %tx 日期与时间类型（x代表不同的日期与时间转换符）

测试用例

↓CloseCode↓

public static void main(String[] args) {    String str = null;    str=String.format("Hi,%s", "王力");    System.out.println(str);    str=String.format("Hi,%s:%s.%s", "王南","王力","王张");    System.out.println(str);    System.out.printf("字母a的大写是：%c %n", 'A');    System.out.printf("3>7的结果是：%b %n", 3>7);    System.out.printf("100的一半是：%d %n", 100/2);    System.out.printf("100的16进制数是：%x %n", 100);    System.out.printf("100的8进制数是：%o %n", 100);    System.out.printf("50元的书打8.5折扣是：%f 元%n", 50*0.85);    System.out.printf("上面价格的16进制数是：%a %n", 50*0.85);    System.out.printf("上面价格的指数表示：%e %n", 50*0.85);    System.out.printf("上面价格的指数和浮点数结果的长度较短的是：%g %n", 50*0.85);    System.out.printf("上面的折扣是%d%% %n", 85);    System.out.printf("字母A的散列码是：%h %n", 'A');}

输出结果

↓CloseCode↓

Hi,王力Hi,王南:王力.王张字母a的大写是：A 3>7的结果是：false 100的一半是：50 100的16进制数是：64 100的8进制数是：144 50元的书打8.5折扣是：42.500000 元上面价格的16进制数是：0x1.54p5 上面价格的指数表示：4.250000e+01 上面价格的指数和浮点数结果的长度较短的是：42.5000 上面的折扣是85% 字母A的散列码是：41 

标识符

搭配转换符的标志，如图所示。

标志 说明 示例 结果 + 为正数或者负数添加符号 ("%+d",15) +15 − 左对齐 ("%-5d",15) 15 0 数字前面补0 ("%04d", 99) 0099 空格 在整数之前添加指定数量的空格 ("% 4d", 99) 99 , 以“,”对数字分组 ("%,f", 9999.99) 9,999.990000 ( 使用括号包含负数 ("%(f", -99.99) (99.990000) # 如果是浮点数则包含小数点，如果是16进制或8进制则添加0x或0 ("%#x", 99)

("%#o", 99) 0x63

0143 < 格式化前一个转换符所描述的参数 ("%f和%<3.2f", 99.45) 99.450000和99.45 $ 被格式化的参数索引 ("%1d,d,s", 99,"abc") 99,abc

测试用例

↓CloseCode↓

public static void main(String[] args) {    String str = null;    //$使用    str=String.format("格式参数$的使用：%1$d,%2$s", 99,"abc");    System.out.println(str);    //+使用    System.out.printf("显示正负数的符号：%+d与%d%n", 99,-99);    //补O使用    System.out.printf("最牛的编号是：%03d%n", 7);    //空格使用    System.out.printf("Tab键的效果是：% 8d%n", 7);    //.使用    System.out.printf("整数分组的效果是：%,d%n", 9989997);    //空格和小数点后面个数    System.out.printf("一本书的价格是：% 50.5f元%n", 49.8);}  

输出结果

↓CloseCode↓

格式参数$的使用：99,abc显示正负数的符号：+99与-99最牛的编号是：007Tab键的效果是：       7  整数分组的效果是：9,989,997一本书的价格是：                                          49.80000元

日期和事件字符串格式化

在程序界面中经常需要显示时间和日期，但是其显示的格式经常不尽人意，需要编写大量的代码经过各种算法才得到理想的日期与时间格式。字符串格式中还有%tx转换符没有详细介绍，它是专门用来格式化日期和时间的。%tx转换符中的x代表另外的处理日期和时间格式的转换符，它们的组合能够将日期和时间格式化成多种格式。

常见日期和时间组合的格式，如图所示。

转换符 说明 示例 c 包括全部日期和时间信息 星期六 十月 27 14:21:20 CST 2007 F “年-月-日”格式 2007-10-27 D “月/日/年”格式 10/27/07 r “HH:MM:SS PM”格式（12时制） 02:25:51 下午 T “HH:MM:SS”格式（24时制） 14:28:16 R “HH:MM”格式（24时制） 14:28

测试用例

↓CloseCode↓

public static void main(String[] args) {    Date date = new Date();    //c的使用    System.out.printf("全部日期和时间信息：%tc%n",date);    //f的使用    System.out.printf("年-月-日格式：%tF%n",date);    //d的使用    System.out.printf("月/日/年格式：%tD%n",date);    //r的使用    System.out.printf("HH:MM:SS PM格式（12时制）：%tr%n",date);    //t的使用    System.out.printf("HH:MM:SS格式（24时制）：%tT%n",date);    //R的使用    System.out.printf("HH:MM格式（24时制）：%tR",date);}  

输出结果

↓CloseCode↓

全部日期和时间信息：星期一 九月 10 10:43:36 CST 2012年-月-日格式：2012-09-10月/日/年格式：09/10/12HH:MM:SS PM格式（12时制）：10:43:36 上午HH:MM:SS格式（24时制）：10:43:36HH:MM格式（24时制）：10:43

定义日期格式的转换符可以使日期通过指定的转换符生成新字符串。这些日期转换符如图所示。

↓CloseCode↓

public static void main(String[] args) {    Date date = new Date();    //b的使用，月份简称    String str=String.format(Locale.US,"英文月份简称：%tb",date);    System.out.println(str);    System.out.printf("本地月份简称：%tb%n",date);    //B的使用，月份全称    str=String.format(Locale.US,"英文月份全称：%tB",date);    System.out.println(str);    System.out.printf("本地月份全称：%tB%n",date);    //a的使用，星期简称    str=String.format(Locale.US,"英文星期的简称：%ta",date);    System.out.println(str);    //A的使用，星期全称    System.out.printf("本地星期的简称：%tA%n",date);    //C的使用，年前两位    System.out.printf("年的前两位数字（不足两位前面补0）：%tC%n",date);    //y的使用，年后两位    System.out.printf("年的后两位数字（不足两位前面补0）：%ty%n",date);    //j的使用，一年的天数    System.out.printf("一年中的天数（即年的第几天）：%tj%n",date);    //m的使用，月份    System.out.printf("两位数字的月份（不足两位前面补0）：%tm%n",date);    //d的使用，日（二位，不够补零）    System.out.printf("两位数字的日（不足两位前面补0）：%td%n",date);    //e的使用，日（一位不补零）    System.out.printf("月份的日（前面不补0）：%te",date);}  

输出结果

↓CloseCode↓

英文月份简称：Sep本地月份简称：九月英文月份全称：September本地月份全称：九月英文星期的简称：Mon本地星期的简称：星期一年的前两位数字（不足两位前面补0）：20年的后两位数字（不足两位前面补0）：12一年中的天数（即年的第几天）：254两位数字的月份（不足两位前面补0）：09两位数字的日（不足两位前面补0）：10月份的日（前面不补0）：10

和日期格式转换符相比，时间格式的转换符要更多、更精确。它可以将时间格式化成时、分、秒甚至时毫秒等单位。格式化时间字符串的转换符如图所示。

转换符 说明 示例 H 2位数字24时制的小时（不足2位前面补0） 15 I 2位数字12时制的小时（不足2位前面补0） 03 k 2位数字24时制的小时（前面不补0） 15 l 2位数字12时制的小时（前面不补0） 3 M 2位数字的分钟（不足2位前面补0） 03 S 2位数字的秒（不足2位前面补0） 09 L 3位数字的毫秒（不足3位前面补0） 015 N 9位数字的毫秒数（不足9位前面补0） 562000000 p 小写字母的上午或下午标记 中：下午

英：pm z 相对于GMT的RFC822时区的偏移量 +0800 Z 时区缩写字符串 CST s 1970-1-1 00:00:00 到现在所经过的秒数 1193468128 Q 1970-1-1 00:00:00 到现在所经过的毫秒数 1193468128984

测试代码

↓CloseCode↓

public static void main(String[] args) {    Date date = new Date();    //H的使用    System.out.printf("2位数字24时制的小时（不足2位前面补0）:%tH%n", date);    //I的使用    System.out.printf("2位数字12时制的小时（不足2位前面补0）:%tI%n", date);    //k的使用    System.out.printf("2位数字24时制的小时（前面不补0）:%tk%n", date);    //l的使用    System.out.printf("2位数字12时制的小时（前面不补0）:%tl%n", date);    //M的使用    System.out.printf("2位数字的分钟（不足2位前面补0）:%tM%n", date);    //S的使用    System.out.printf("2位数字的秒（不足2位前面补0）:%tS%n", date);    //L的使用    System.out.printf("3位数字的毫秒（不足3位前面补0）:%tL%n", date);    //N的使用    System.out.printf("9位数字的毫秒数（不足9位前面补0）:%tN%n", date);    //p的使用    String str = String.format(Locale.US, "小写字母的上午或下午标记(英)：%tp", date);    System.out.println(str);    System.out.printf("小写字母的上午或下午标记（中）：%tp%n", date);    //z的使用    System.out.printf("相对于GMT的RFC822时区的偏移量:%tz%n", date);    //Z的使用    System.out.printf("时区缩写字符串:%tZ%n", date);    //s的使用    System.out.printf("1970-1-1 00:00:00 到现在所经过的秒数：%ts%n", date);    //Q的使用    System.out.printf("1970-1-1 00:00:00 到现在所经过的毫秒数：%tQ%n", date);}

输出结果

↓CloseCode↓

2位数字24时制的小时（不足2位前面补0）:112位数字12时制的小时（不足2位前面补0）:112位数字24时制的小时（前面不补0）:112位数字12时制的小时（前面不补0）:112位数字的分钟（不足2位前面补0）:032位数字的秒（不足2位前面补0）:523位数字的毫秒（不足3位前面补0）:7739位数字的毫秒数（不足9位前面补0）:773000000小写字母的上午或下午标记(英)：am小写字母的上午或下午标记（中）：上午相对于GMT的RFC822时区的偏移量:+0800时区缩写字符串:CST1970-1-1 00:00:00 到现在所经过的秒数：13472462321970-1-1 00:00:00 到现在所经过的毫秒数：1347246232773

总结

详情可以查阅jdk5之后的官方文档中的java.util.Formatter类，有相关说明，本文的所有演示都取自此处。

作者：Nemo

链接：

来源：博客园