String.format(format,args...)的使用解析
使用kotlin 中使用示例
==========================================================================================================
java中的使用示例:
public static void main(String[] args) { String url = String.format("http://%s/%s?loginName=%s&loginPwd=%s", "ms-ten","ten/sc/query","1300000000","123456"); System.out.println(url); }
即 根据第一个参数中的%s,分别将后面的参数依次替换第一个参数中的%s
如果后面的参数个数多于第一个参数中的%s,那么 多余的参数不会进行任何替换操作。
===========================================================================================================
从上面的使用例子可以看出,String.format(format,args...)是用来【按照format中指定格式】来【格式化字符串来输出新的字符串】的。
下面具体解析一下使用方法
1.首先,看看通常怎么使用的
int = 123; str = “字符串”–%s对应参数str,–%i对应参数int newStr = string.format(“这是字符串:’%s‘ 这是数字值 %i“,str,int);
注意点:
1》第一个参数用format表示输出的格式,每个%符号后面是一个格式化表达式,每个格式化表达式按顺序对应后面的参数。 所以用了N个格式化表达式,就必须在后面添加N个参数。
2.再通过一个例子深入解析
int = 123;–%05d表示格式化为至少五位的数字,不足在前面补0 newStr = string.format(“%05d“,int);
注意点:
2》格式化表达式:%[零个或多个标志][最小字段宽度][精度][修改符]格式码
3》[]方括号表示可选参数
3.具体说明每一部分的功能
3.1、格式码
代码 c 参数 数字值(number) 含义 参数被裁剪为8位字节码并作为字符进行打印。
代码 i,d 参数 数字值(number) 含义 参数作为一个十进制整数打印。如果给出了精度而且值的位数小于精度位数,前面就用0填充。
代码 u,o,x,X 参数 数字值(number) 含义 参数作为一个无符号数字值打印,u使用十进制,o使用八进制,x或X使用十六进制,两者的区别是x约定使用abcdef,而X约定使用ABCDEF。
代码 e,E 参数 数字值(number) 含义 参数根据指数形式打印。例如,6.023000e23是使用代码e,6.023000E23是使用代码E。小数点后面的位数由精度字段决定,缺省值是6。
代码 f 参数 数字值(number) 含义 参数按照的常规浮点格式打印。精度字段决定小数点后面的位数,缺省值是6。
代码 g,G 参数 数字值(number) 含义 参数以%f或%e(如G则%E)的格式打印,取决于它的值。如果指数大于等于-4但小于精度字段就使用%f格式,否则使用指数格式。
代码 s 参数 字符串值(string) 含义 打印一个字符串。
代码 q 参数 (无) 含义 打印一个字符串,并将字符串置于一对引号中,如果字符串中包含引号换行等自动添加转义符。如果要读取一个字符串传为脚本代码。为避免用户恶意注入引号等特殊字符,可以使用%q进行格式化。
代码 % 参数 (无) 含义 取消%转义打印一个%字符,即用%%表示本来的%。
3.2、 标志
标志 – 含义 值在字段中做对齐,缺省情况下是右对齐。
标志 0 含义 当数值为右对齐时,缺省情况下是使用空格填充值左边未使用的列。这个标志表示用零填充,它可用于d,i,u,o,x,X,e,E,f,g和G代码。 使用d,i,u,o,x和X代码时,如果给出了精度字段,零标志就被忽略。如果格式代码中出现了负号,零标志也没有效果。
标志 + 含义 当用于一个格式化某个有符号值代码时,如果值非负,正号标志就会给它加上一个正号。如果该值为负,就像往常一样显示一个负号。在 缺省情况下,正号并不会显示。
标志 空格 含义 只用于转换有符号值的代码。当值非负时,这个标志把一个空格添加到它开始的位置。注意这个标志和正号标志是相互排斥的,如果两个 同时给出,空格标志便被忽略。
标志 # 含义 选择某些代码的另一种转换形式:
用于… #标志… o 保证产生的值以一个零开头 x,X 在非零值前面加0x前缀(%X则为0X) e,E,f 确保结果始终包含一个小数点,即使它后面没有数字 g,G 和上面的e,E和f代码相同。另外,缀尾的0并不从小数中去除
3.3、 字段宽度
字段宽度是一个十进制整数,用于指定将出现在结果中的最小字符数。如果值的字符数少于字段宽度,就对它进行填充以增加长度。
3.4、 精度
精度以一个句点开头,后面跟一个可选的十进制数。如果未给出整数,精度的缺省值为零。
对于d,i,u,o,x和X类型的转换,精度字段指定将出现在结果中的最小的数字个数并覆盖零标志。如果转换后的值的位数小于宽度,就在它的前面插入零。如果值为零且精度也为零,则转换结果就不会产生数字。
对于e,E和f类型的转换,精度决定将出现在小数点之后的数字位数。
对于g和G类型的转换,它指定将出现在结果中的最大有效位数。
当使用s类型的转换时,精度指定将被转换的最多的字符数。
如果用于表示字段宽度和/或精度的十进制整数由一个星号代替,那么printf的下一个参数(必须是个整数)就提供宽度和(或)精度。因此, 这些值可以通过计算获得而不必预先指定。
3.5、示例
常规类型的格式化
表1 转换符
转 换 符 | 说 明 | 示 例 |
%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代表不同的日期与时间转换符 |
代码示例:
@Test public void stringFormat(){ String str=null; str=String.format("Hi,%s", "飞龙"); // 格式化字符串 System.out.println(str); // 输出字符串变量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'); }
结果:
搭配标志
这些字符串格式参数不但可以灵活将其他数据类型转换成字符串,而且可以与各种标志组合在一起,生成各种格式的字符串,这些标志如表2所示。
表2 搭配转换符的标志
标 志 | 说 明 | 示 例 | 结 果 |
+ | 为正数或者负数添加符号 | ("%+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,%2$s", 99,"abc") | 99,abc |
代码示例:
@Test public void stringFormat(){ String str=null; str=String.format("格式参数$的使用:%1$d,%2$s", 99,"abc"); // 格式化字符串 System.out.println(str); // 输出字符串变量 System.out.printf("显示正负数的符号:%+d与%d%n", 99,-99); System.out.printf("最牛的编号是:%03d%n", 7); System.out.printf("Tab键的效果是:% 8d%n", 7); System.out.printf("整数分组的效果是:%,d%n", 9989997); System.out.printf("一本书的价格是:%2.2f元%n", 49.8); }
结果:
日期和时间字符串格式化
在程序界面中经常需要显示时间和日期,但是其显示的 格式经常不尽人意,需要编写大量的代码经过各种算法才得到理想的日期与时间格式。字符串格式中还有%tx转换符没有详细介绍,它是专门用来格式化日期和时 间的。%tx转换符中的x代表另外的处理日期和时间格式的转换符,它们的组合能够将日期和时间格式化成多种格式。
常见日期时间格式化
格式化日期与时间的转换符定义了各种格式化日期字符串的方式,其中最常用的日期和时间的组合格式如表3所示。
表3 常见日期和时间组合的格式
转 换 符 | 说 明 | 示 例 |
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 |
代码示例:
@Test public void stringFormat(){ Date date=new Date(); // 创建日期对象 System.out.printf("全部日期和时间信息:%tc%n",date); // 格式化输出日期或时间 System.out.printf("年-月-日格式:%tF%n",date); System.out.printf("月/日/年格式:%tD%n",date); System.out.printf("HH:MM:SS PM格式(12时制):%tr%n",date); System.out.printf("HH:MM:SS格式(24时制):%tT%n",date); System.out.printf("HH:MM格式(24时制):%tR",date); }
结果:
格式化日期字符串
定义日期格式的转换符可以使日期通过指定的转换符生成新字符串。这些日期转换符如表4所示。
表4 日期格式化转换符
转 换 符 | 说 明 | 示 例 |
b或者h | 月份简称 | 中:十月 英:Oct |
B | 月份全称 | 中:十月 英:October |
a | 星期的简称 | 中:星期六 英:Sat |
A | 星期的全称 | 中:星期六 英:Saturday |
C | 年的前两位数字(不足两位前面补0) | 20 |
y | 年的后两位数字(不足两位前面补0) | 07 |
Y | 4位数字的年份(不足4位前面补0) | 2007 |
j | 一年中的天数(即年的第几天) | 300 |
m | 两位数字的月份(不足两位前面补0) | 10 |
d | 两位数字的日(不足两位前面补0) | 27 |
e | 月份的日(前面不补0) | 5 |
代码示例:
package com.sxd.test;import org.junit.Test;import java.util.Date;import java.util.Locale;public class StringFormat { @Test public void stringFormat(){ Date date=new Date(); // 创建日期对象 String str=String.format(Locale.US,"英文月份简称:%tb",date); // 格式化日期字符串 System.out.println(str); // 输出字符串内容 System.out.printf("本地月份简称:%tb%n",date); str=String.format(Locale.US,"英文月份全称:%tB",date); System.out.println(str); System.out.printf("本地月份全称:%tB%n",date); str=String.format(Locale.US,"英文星期的简称:%ta",date); System.out.println(str); System.out.printf("本地星期的简称:%tA%n",date); System.out.printf("年的前两位数字(不足两位前面补0):%tC%n",date); System.out.printf("年的后两位数字(不足两位前面补0):%ty%n",date); System.out.printf("一年中的天数(即年的第几天):%tj%n",date); System.out.printf("两位数字的月份(不足两位前面补0):%tm%n",date); System.out.printf("两位数字的日(不足两位前面补0):%td%n",date); System.out.printf("月份的日(前面不补0):%te",date); }}
结果:
格式化时间字符串
和日期格式转换符相比,时间格式的转换符要更多、更精确。它可以将时间格式化成时、分、秒甚至时毫秒等单位。格式化时间字符串的转换符如表5所示。
表5 时间格式化转换符
转 换 符 | 说 明 | 示 例 |
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 |
代码示例:
package com.sxd.test;import org.junit.Test;import java.util.Date;import java.util.Locale;public class StringFormat { @Test public void stringFormat(){ Date date=new Date(); // 创建日期对象 System.out.printf("2位数字24时制的小时(不足2位前面补0):%tH%n",date); System.out.printf("2位数字12时制的小时(不足2位前面补0):%tI%n",date); System.out.printf("2位数字24时制的小时(前面不补0):%tk%n",date); System.out.printf("2位数字12时制的小时(前面不补0):%tl%n",date); System.out.printf("2位数字的分钟(不足2位前面补0):%tM%n",date); System.out.printf("2位数字的秒(不足2位前面补0):%tS%n",date); System.out.printf("3位数字的毫秒(不足3位前面补0):%tL%n",date); System.out.printf("9位数字的毫秒数(不足9位前面补0):%tN%n",date); String str=String.format(Locale.US,"小写字母的上午或下午标记(英):%tp",date); System.out.println(str); // 输出字符串变量str的内容 System.out.printf ("小写字母的上午或下午标记(中):%tp%n",date); System.out.printf("相对于GMT的RFC822时区的偏移量:%tz%n",date); System.out.printf("时区缩写字符串:%tZ%n",date); System.out.printf("1970-1-1 00:00:00 到现在所经过的秒数:%ts%n",date); System.out.printf("1970-1-1 00:00:00 到现在所经过的毫秒数:%tQ%n",date); }}
结果: