【String】String.format(format,args...)的使用解析

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

    }

}

结果：