Java菜鸟笔记：String.format()

在开发项目打印日志的时候，需要记一些带有变量的日志，经常会用到String.format()，什么？你没用过？
那我猜你一定是这样打印的：

//以System.out代替日志打印作为事例：
int a = 10;
System.out.println(“这里有一个变量值：” + a + “，后续文字”);

控制台输出：
这里有一个变量：10,后续文字。

如果你用String.format()就可以这样写：

int a = 10;
System.out.println(String.format("这里有一个变量：%d,后续文字。", a));

控制台输出：
这里有一个变量：10,后续文字。

很明显第二种方式比第一种方式要好，因为第二种方式的文字部分 “这里有一个变量：%d,后续文字。” 可以作为一个常量存储起来，第一种方式没办法将文字部分复用，在日志打印的实用中，复用日志是很常见的场景：

//将文字部分定义为一个变量
public final static String message = "这里有一个变量：%d,后续文字。";
System.out.println(String.format(message, a));

控制台输出：
这里有一个变量：10,后续文字。

这只是String.format()方法的应用场景之一，但是你以为它只能这么用就大错特错了。
format不止于记日志。
要介绍String.format()的全部用法，要先揭开java.util.Formatter;的面纱。

Formatter

在java中，所有新的格式化功能都由Formatter类来完成，包括上面提到的String.format(),我们来看一下String.format()的源码：

 public static String format(String format, Object... args) {
        return new Formatter().format(format, args).toString();
    }

 // format的重载方法，第一个参数可以设置语言实现本地化
 public static String format(Locale l, String format, Object... args) {
        return new Formatter(l).format(format, args).toString();
    }

下面是常用的Formatter类定义的类型转换和转换符的用法示例：

转换符	详细说明	示例
%s	字符串类型	“字符串”
%c	字符类型	|‘m’|
%b	布尔类型	true
%d	整数类型（十进制）	88
%x	整数类型（十六进制）	FF
%o	整数类型（八进制）	77
%f	浮点类型	8.888
%a	十六进制浮点类型	FF.35AE
%e	指数类型	9.38e+5
%g	通用浮点类型（f和e类型中较短的）	不举例(基本用不到)
%h	散列码	不举例(基本用不到)
%%	百分比类型 ％	(%是特殊字符，写成%%才能显示%)
%n	换行符	不举例(基本用不到)
%tx	日期与时间类型（x代表不同的日期与时间转换符)	不举例(基本用不到)

示例：(注意： System.out.printf() = System.out.print(String.format())😉

    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("字母c的大写是：%c %n", 'C');  
    System.out.printf("布尔结果是：%b %n", "小超".equal("帅哥"));  
    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'); 

控制台结果：

Hi,小超
Hi,小超 是个 大帅哥
字母c的大写是：C 
布尔结果是：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
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

日期转换符

标志	说明	示例
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

代码示例 (注意： System.out.printf() = System.out.print(String.format())😉：

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); 

控制台输出：

全部日期和时间信息：星期日 八月 02 18:21:54 CST 2020
年-月-日格式：2020-08-02
月/日/年格式：08/02/20
HH:MM:SS PM格式（12时制）：06:21:54 下午
HH:MM:SS格式（24时制）：18:21:54
HH:MM格式（24时制）：18:21

更多用法请参考java.util.Formatter doc