String.format()方法详解

前言：

String.format()作为文本处理工具，为我们提供强大而丰富的字符串格式化功能，这里根据查阅的资料做个学习笔记，整理成如下文章，供后续复习查阅。

一. format()方法的两种重载形式：

format(String format, Object … args)

该方法使用指定的格式字符串和参数返回一个格式化的字符串，格式化后的新字符串使用本地默认的语言环境。

format(Local l, String format, Pbject … args)

其中，参数l为格式化过程中要应用的语言环境。如果l为null，则不进行本地化。

二. 占位符：

1.对整数进行格式化：%[index$][标识][最小宽度]转换方式

格式化字符串由4部分组成，特殊的格式常以%index$开头，index从1开始取值，表示将第index个参数拿进来进行格式化，[最小宽度]的含义也很好理解，就是最终该整数转化的字符串最少包含多少位数字。剩下2个部分的含义：

标识：

‘-’ 在最小宽度内左对齐，不可以与"用0填充"同时使用
‘#’ 只适用于8进制和16进制，8进制时在结果前面增加一个0，16进制时在结果前面增加0x
‘+’ 结果总是包括一个符号(一般情况下只适用于10进制，若对象为BigInteger才可以用于8进制和16进制)
’ ’ 正值前加空格，负值前加负号(一般情况下只适用于10进制，若对象为BigInteger才可以用于8进制和16进制)
‘0’ 结果将用零来填充
‘,’ 只适用于10进制，每3位数字之间用"，"分隔
‘(’ 若参数是负数，则结果中不添加负号而是用圆括号把数字括起来(同’+'具有同样的限制)

转换方式：

d-十进制 o-八进制 x或X-十六进制

举个例子，如下：

System.out.println(String.format("%1$-9d", 312356));
System.out.println(String.format("%1$#9x", 312356));
System.out.println(String.format("%1$-#9o", 312356));
System.out.println(String.format("%1$+9d", 312356));
System.out.println(String.format("%1$ 9d", 312356));
System.out.println(String.format("%1$ 9d", -312356));
System.out.println(String.format("%1$09d", 312356));
System.out.println(String.format("%1$,9d", 312356));
System.out.println(String.format("%1$(9d", 312356));

输出结果：

312356   0x4c424
01142044 +312356312356-312356
000312356312,356312356

2.对浮点数进行格式化：%[index$][标识][最少宽度][.精度]转换方式

我们可以看到，浮点数的转换多了一个"精度"选项，可以控制小数点后面的位数。

标识：

‘-’ 在最小宽度内左对齐，不可以与"用0填充"同时使用
‘+’ 结果总是包括一个符号
’ ’ 正值前加空格，负值前加负号
‘0’ 结果将用零来填充
‘,’ 每3位数字之间用"，"分隔(只适用于fgG的转换)
‘(’ 若参数是负数，则结果中不添加负号而是用圆括号把数字括起来(只适用于eEfgG的转换)

转换方式：

‘e’, ‘E’ – 结果被格式化为用计算机科学记数法表示的十进制数
‘f’ – 结果被格式化为十进制普通表示方式
‘g’, ‘G’ – 根据具体情况，自动选择用普通表示方式还是科学计数法方式
‘a’, ‘A’ – 结果被格式化为带有效位数和指数的十六进制浮点数

 System.out.println(String.format("%1$-9.2f", 3123.32));System.out.println(String.format("%1$+9.2f", 3123.32));System.out.println(String.format("%1$ 9.2f", -3123.32));System.out.println(String.format("%1$ 9.2f", 3123.32));System.out.println(String.format("%1$09.2f", 3123.32));System.out.println(String.format("%1$,9.2f", 3123.32));System.out.println(String.format("%1$(9.2f", -3123.32));System.out.println(String.format("%1$9.2e", -3123.32));System.out.println(String.format("%1$9.2f", -3123.32));System.out.println(String.format("%1$9.2g", -3123.32));System.out.println(String.format("%1$9.2a", -3123.32));

输出结果：

 3123.32  +3123.32-3123.323123.32003123.323,123.32(3123.32)-3.12e+03-3123.32-3.1e+03-0x1.86p11

3.对字符进行格式化：

对字符进行格式化是非常简单的，c表示字符，标识中’-'表示左对齐，其他就没什么了。

三. 对日期进行格式化：

常用的日期格式转换符如下表所示：

转换符	说明	示例
%te	一个月中的某一天（1～31）	2
%tb	指定语言环境的月份简称	Feb(英文)、二月（中文）
%tB	指定语言环境的月份全称	February(英文)、二月(中文)
%tA	指定语言环境的星期几全称	Monday(英文)、星期一（中文）
%ta	指定语言环境的星期几简称	Mon(英文)、星期一（中文）
%tc	包括全部日期和时间信息	星期二三月 25 13:37:22 CST 2008
%tY	4位年份	2019
%tj	一年中的第几天（001～366）	085
%tm	月份	03
%td	一个月中的第几天（01～31）	02
%ty	2位年份	19

举个例子，如下：

 public class Eval {public static void main(String[] args) {Date date = new Date();String day = String.format("%te", date);System.out.println("今天是2019年8月：" + day + "号");String month = String.format("%tb", date);System.out.println("现在是2019年：" + month);String xingqi = String.format("%tA", date);System.out.println("今天是：" + xingqi);String year = String.format("%tY", date);System.out.println("现在是：" + year + "年");}}

输出结果：

今天是2019年8月：20号
现在是2019年：八月
今天是：星期二
现在是：2019年

常用的时间格式转换符如下表所示：

转换符	说明	示例
%tH	2位数字的24时制的小时（00～23）	14
%tI	2位数字的12时制的小时（01～12）	05
%tk	2位数字的24时制的小时（0～23）	5
%tl	2位数字的12时制的小时（1～12）	10
%tM	2位数字的分钟（00～59）	05
%tS	2位数字的秒数（00～60）	12
%tL	3位数字的毫秒数（000～999）	920
%tN	9位数字的微秒数（000000000～999999999）	062000000
%tp	指定语言环境下上午或下午标记	下午（中文）、pm（英文）
%tz	相对于GMT RFC 82格式的数字时区偏移量	+0800
%tZ	时区缩写形式的字符串	CST
%ts	1970-01-01 00:00:00至现在经过的秒数	1206345534
%tQ	1970-01-01 00:00:00至现在经过的毫秒数	12923409349034

举个例子，如下：

 public class GetDate {public static void main(String[] args) {Date date = new Date();String hour = String.format("%tH", date);String minute = String.format("%tM", date);String second = String.format("%tS", date);System.out.println("现在是：" + hour + "点" + minute + "分" + second + "秒");System.out.println("##################################");String hour2 = String.format("%tI", date);String pm = String.format("%tp", date);System.out.println("现在是：" + pm + hour2 + "点" + minute + "分" + second + "秒");}
}

输出结果：

 现在是：15点06分37秒##################################现在是：下午03点06分37秒

常见的日期和时间组合的格式如下表所示：

转换符	说明	示例
%tF	“年-月-日”格式（4位年份）	2019-08-20
%tD	“年/月/日”格式（2位年份）	08/20/19
%tc	全部日期和时间信息	星期二三月 25 15:20:00 CST 2019
%tr	“时：分：秒 PM(AM)”格式（12时制）	03:22:06 下午
%tT	“时：分：秒”格式（24时制）	15:23:50
%tR	“时：分”格式（24时制）	15:25

举个例子，如下：

 public class DateAndTime {public static void main(String[] args) {Date date = new Date();String time = String.format("%tc", date);String form = String.format("%tF", date);String form2 = String.format("%tD", date);String form3 = String.format("%tr", date);String form4 = String.format("%tT", date);String form5 = String.format("%tR", date);System.out.println("全部的时间信息是：" + time);System.out.println("年-月-日格式：" + form);System.out.println("年/月/日格式：" + form2);System.out.println("时：分：秒 PM(AM)格式：" + form3);System.out.println("时：分：秒格式：" + form4);System.out.println("时：分格式：" + form5);}
}

输出结果：

 全部的时间信息是：星期二 八月 20 15:14:20 CST 2019年-月-日格式：2019-08-20年/月/日格式：08/20/19时：分：秒 PM(AM)格式：03:14:20 下午时：分：秒格式：15:14:20时：分格式：15:14

结尾：

以上内容为format()方法的一些常用功能，也是本人在工作场景中经常用到的。整理归纳方便后续学习查阅，如果后面还有遇到相关方法的其他用法，后期再对该篇文章进行补充。