String.format()详解与遇到的问题（UnknownFormatConversionException）

前言

最近在写代码的时候项目报错了，控制台显示的是这个异常。（java.util.UnknownFormatConversionException: Conversion = ‘T’）然后发现这个异常是format()其中的字符串参数中不需要转义的%引起的。就想着在这里整理一篇String.format()这个方法。

String.format()简介

String类的format()方法用于创建格式化的字符串以及连接多个字符串对象。而他具有两种重载方法。

• format(String format, Object… args) 新字符串使用本地语言环境，制定字符串格式和参数生成格式化的新字符串。
• format(Locale locale, String format, Object… args) 使用指定的语言环境，制定字符串格式和参数生成格式化的字符串。
  在我看到这两个方法解释的时候还是有点懵的。不知道解释中的语言环境是啥。

  String usMName = String.format(Locale.US,"美国环境周几%ta",new Date());
        String mName= String.format("本地环境周几%ta",new Date());
        System.out.println(usMName);
        System.out.println(mName);

运行结果为

美国环境周几Mon
本地环境周几星期一

这就是语言环境,不同的国家不同的月份 ，星期几等。返回的是不同的。

使用不同转换符实现不同数据类型到字符串的转换。

转换符	说明	示例	结果
%s	字符串类型	String.format(“你好 %s”,“张三”)	你好 张三
%c	字符类型	String.format("%c %c %c",‘A’,‘B’,‘C’)	A B C
%b	波尔类型	String.format("%b",true)	true
%d	整数类型 (十进制)	String.format(“分数:%d”,99)	分数:99
%x	整数类型（十六进制）	String.format(“16进制:%x”,122)	16进制:7a
%o	整数类型（八进制）	String.format(“8进制:%x”,122)	8进制:172
%f	浮点类型	String.format(“浮点类型:%f”,99.99)	99.990000
%a	16进制浮点类型	String.format(“16进制浮点型：%a”,122.122)	0x1.e87ced916872bp6
%e	指数类型	String.format(“指数类型:%e”,50*0.85)	指数类型:4.250000e+01
%g	通用浮点类型(指数类型和浮点类型较短的是)	String.format(“指数类型和浮点型较短的是:%g”,50*0.85)	指数类型和浮点型较短的是:42.5000
%h	散列码	String.format(“A的散列码是:%h”,‘A’)	A的散列码是:41
%n	换行符号
%%	百分号	String.format(“99%%”)	99%
%tx	日期与时间类型（x代表不同的日期与时间转换符

日期和时间字符串格式化

在上面的表格中没有日期与时间类型的格式化例子。因为它的种类比较多。在这里对他进行详细解释。在程序上我们经常需要显示固定格式的时间日期字符串。但是程序返给我的结果大多数的时候是不满足我们的要求的。而上面的%tx是专门用来格式化时间的。其中x代表另外的处理日期和时间格式的转换符，它们的组合能够将日期和时间格式化成多种格式。

转换符	说明	示例	结果
c	包括全部日期和时间信息(格林威治)	String.format(“全部日期和时间信息：%tc”,new Date())	全部日期和时间信息：星期二 五月 11 09:42:38 CST 2021
F	“年-月-日”格式	String.format(“年-月-日格式：%tF”,new Date())	年-月-日格式：2021-05-11
D	“月/日/年”格式	String.format(“月/日/年格式：%tD”,new Date())	月/日/年格式：05/11/21
r	“HH:MM:SS PM”格式（12时制)	String.format(“HH:MM:SS PM格式（12时制）：%tr”,new Date())	HH:MM:SS PM格式（12时制）：09:42:38 上午
T	“HH:MM:SS”格式（24时制）	String.format(“HH:MM:SS格式（24时制）：%tT”,new Date())	HH:MM:SS格式（24时制）：09:42:38
R	“HH:MM”格式（24时制）	String.format(“HH:MM格式（24时制）：%tR”,new Date())	HH:MM格式（24时制）：09:42

我们可以通过制定语言环境让日期类型的数据转换成不同的字符串格式。例如:

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

结果

英文月份简称：May
本地月份简称：五月
英文月份全称：May
本地月份全称：五月>
英文星期的简称：Tue
本地星期的简称：星期二
年的前两位数字（不足两位前面补0）：20
年的后两位数字（不足两位前面补0）：21
一年中的天数（即年的第几天）：131
两位数字的月份（不足两位前面补0）：05
两位数字的日（不足两位前面补0）：11
月份的日（前面不补0）：11

和日期格式转换符相比，时间格式转换符要更多更精确。

转换符	说明	示例	结果
H	24小时制的小时（不足两位补零）	format(“tH:%tH%n”, new Date())	tH:10
k	24小时制的小时（不足两位不补零）	format(“tK:%tk%n”, new Date())	tK:10
I,	12小时制的小时（不足两位补零）	format(“tI:%tI%n”, new Date())	tI:10
l	12小时制的小时（不足两位不补零）	format(“tl:%tl%n”, new Date())	tl:10
M	分钟（不足两位补零）	format(“tM:%tM%n”, new Date())	tM:26
S	秒（不足两位补零）	format(“tS:%tS%n”, new Date())	tS:32
L	毫秒（不足三位补零）	format(“tL:%tL%n”, new Date())	tL:522
N	毫秒（不足9位补零）	format(“tN:%tN%n”, new Date())	tN:522000000
p	小写字母的上午或下午标记，如中文为“下午”，英文为pm	format(Locale.US, “小写字母的上午或下午标记(英)：%tp”, new Date()) format(“tp：%tp%n”, new Date())	小写字母的上午或下午标记(英)：am tp：上午
z	相对于GMT的时区偏移量，如+0800	format(“tz:%tz%n”, new Date())	tz:+0800
Z	时区缩写，如CST	format(“tZ:%tZ%n”, new Date())	tZ:CST
s	自1970-1-1 00:00:00起经过的秒数	format(“ts：%ts%n”, new Date())	ts：1620699992
Q	自1970-1-1 00:00:00起经过的豪秒	format(“tQ：%tQ%n”, new Date())	tQ：1620699992522

转换符的标志

标志	说明	示例	结果
+	为正数或者负数添加符号	("%+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
$	被格式化的参数索引	("%1$d,$s", 99,“abc”)	99,abc

---

最后欢迎大家访问我的个人博客网站:zShare个人博客