JAVA字符串类型-String.format()函数用法

Static String format ( String  format,  Object ... args)

该函数为静态类型，可直接使用。
format 参数为要使用的格式，而args为需要被格式化的参数。
format参数的选择和C语言中sprintf（）方法的输出格式参数类似。

Java中IO包里PrintWriter类的
printf(Locale l, String format, Object... args)
printf(String format, Object... args)  
方法也支持格式化参数。


一般格式化参数形式为%[index$][标志][最小宽度] [转换方式]
显式索引 [index$]是在格式说明符中包含参数索引时使用。参数索引是一个十进制整数，用于指示参数在参数列表中的位置。第一个参数由 "1$" 引用，第二个参数由 "2$" 引用，依此类推。可以多次引用任何一个参数。 
格式字符串语法
  
  
  
  


  
  
  
  
产生格式化输出的每个方法都需要格式字符串 和参数列表。格式字符串是一个 String，它可以包含固定文本以及一个或多个嵌入的格式说明符。请考虑以下示例：

  
  
  
  

   
   
   
   
   Calendar c = ...;
   String s = String.format("Duke's Birthday: %1$tm %1$te,%1$tY", c);
 
  
  
  
  
此格式字符串是 format 方法的第一个参数。它包含三个格式说明符 "%1$tm"、"%1$te" 和 "%1$tY"，它们指出应该如何处理参数以及在文本的什么地方插入它们。格式字符串的其余部分是包括 "Dukes Birthday: " 和其他任何空格或标点符号的固定文本。 参数列表由传递给位于格式字符串之后的方法的所有参数组成。在上述示例中，参数列表的大小为 1，由对象 Calendar c 组成。

应该注意标志和转换方式的不同
例子：
	private static String lpad(int length, int number) {
        String f = "%0" + length + "d";
        return String.format(f, number);
		}
以上是一个格式化流水号函数。可以对number参数进行格式化，在其前添加0

标志
下表总结了受支持的标志。y 表示该标志受指示参数类型支持。
  
  
  
  

   
   
   
   
 
    
 
     
标志
 
     
常规
 
     
字符
 
     
整数
 
     
浮点
 
     
日期/时间
 
     
说明
 
    
 
    
 
     
'-'
 
     
y
 
     
y
 
     
y
 
     
y
 
     
y
 
     
结果将是左对齐的。
 
    
 
    
 
     
'#'
 
     
y1
 
     
-
 
     
y3
 
     
y
 
     
-
 
     
结果应该使用依赖于转换类型的替换形式
 
    
 
    
 
     
'+'
 
     
-
 
     
-
 
     
y4
 
     
y
 
     
-
 
     
结果总是包括一个符号
 
    
 
    
 
     
'  '
 
     
-
 
     
-
 
     
y4
 
     
y
 
     
-
 
     
对于正值，结果中将包括一个前导空格
 
    
 
    
 
     
'0'
 
     
-
 
     
-
 
     
y
 
     
y
 
     
-
 
     
结果将用零来填充
 
    
 
    
 
     
','
 
     
-
 
     
-
 
     
y2
 
     
y5
 
     
-
 
     
结果将包括特定于语言环境的组分隔符
 
    
 
    
 
     
'('
 
     
-
 
     
-
 
     
y4
 
     
y5
 
     
-
 
     
结果将是用圆括号括起来的负数
 
    
 
   
  
  
  
  
1 取决于 Formattable 的定义。


2 只适用于 'd' 转换。


3 只适用于 'o'、'x' 和 'X' 转换。


4 对 BigInteger 应用 'd'、'o'、'x' 和 'X' 转换时，或者对 byte 及 Byte、short 及 Short、int 及 Integer、long 及 Long 分别应用 'd' 转换时适用。


5 只适用于 'e'、'E'、'f'、'g' 和 'G' 转换。


任何未显式定义为标志的字符都是非法字符，并且都被保留，以供扩展使用。


转换
转换可分为以下几类：
  
  
  
  

   
   
   
   
常规 - 可应用于任何参数类型
   
   
   
   
字符 - 可应用于表示 Unicode 字符的基本类型：char、Character、byte、Byte、short 和 Short。当 Character.isValidCodePoint(int) 返回 true 时，可将此转换应用于 int 和 Integer 类型
   
   
   
   
数值 
    
 
     
整数 - 可应用于 Java 的整数类型：byte、Byte、short、Short、int、Integer、long、Long 和 BigInteger
 
     
浮点 - 可用于 Java 的浮点类型：float、Float、double、Double 和 BigDecimal
 
    
   
   
   
   
日期/时间 - 可应用于 Java 的、能够对日期或时间进行编码的类型：long、Long、Calendar 和 Date。
   
   
   
   
百分比 - 产生字面值 '%' ('\u0025')
   
   
   
   
行分隔符 - 产生特定于平台的行分隔符
  
  
  
  
下表总结了受支持的转换。

  
  
  
  

   
   
   
   
 
    
 
     
转换
 
     
参数类别
 
     
说明
 
    
 
    
 
     
'b', 'B'
 
     
常规
 
     
如果参数 arg 为 null，则结果为 "false"。如果 arg 是一个 boolean 值或 Boolean，则结果为 String.valueOf() 返回的字符串。否则结果为 "true"。
 
    
 
    
 
     
'h', 'H'
 
     
常规
 
     
如果参数 arg 为 null，则结果为 "null"。否则，结果为调用 Integer.toHexString(arg.hashCode()) 得到的结果。
 
    
 
    
 
     
's', 'S'
 
     
常规
 
     
如果参数 arg 为 null，则结果为 "null"。如果 arg 实现 Formattable，则调用 arg.formatTo。否则，结果为调用 arg.toString() 得到的结果。
 
    
 
    
 
     
'c', 'C'
 
     
字符
 
     
结果是一个 Unicode 字符
 
    
 
    
 
     
'd'
 
     
整数
 
     
结果被格式化为十进制整数
 
    
 
    
 
     
'o'
 
     
整数
 
     
结果被格式化为八进制整数
 
    
 
    
 
     
'x', 'X'
 
     
整数
 
     
结果被格式化为十六进制整数
 
    
 
    
 
     
'e', 'E'
 
     
浮点
 
     
结果被格式化为用计算机科学记数法表示的十进制数
 
    
 
    
 
     
'f'
 
     
浮点
 
     
结果被格式化为十进制数
 
    
 
    
 
     
'g', 'G'
 
     
浮点
 
     
根据精度和舍入运算后的值，使用计算机科学记数形式或十进制格式对结果进行格式化。
 
    
 
    
 
     
'a', 'A'
 
     
浮点
 
     
结果被格式化为带有效位数和指数的十六进制浮点数
 
    
 
    
 
     
't', 'T'
 
     
日期/时间
 
     
日期和时间转换字符的前缀。请参阅日期/时间转换。
 
    
 
    
 
     
'%'
 
     
百分比
 
     
结果为字面值 '%' ('\u0025')
 
    
 
    
 
     
'n'
 
     
行分隔符
 
     
结果为特定于平台的行分隔符
 
    
 
   
  
  
  
  

以下日期和时间转换的后缀字符是为 't' 和 'T' 转换定义的。
以下转换字符用来格式化时间：
  
  
  
  

   
   
   
   
 
    
 
     
'H'
 
     
24 小时制的小时，被格式化为必要时带前导零的两位数，即 00 - 23。
 
    
 
    
 
     
'I'
 
     
12 小时制的小时，被格式化为必要时带前导零的两位数，即 01 - 12。
 
    
 
    
 
     
'k'
 
     
24 小时制的小时，即 0 - 23。
 
    
 
    
 
     
'l'
 
     
12 小时制的小时，即 1 - 12。
 
    
 
    
 
     
'M'
 
     
小时中的分钟，被格式化为必要时带前导零的两位数，即 00 - 59。
 
    
 
    
 
     
'S'
 
     
分钟中的秒，被格式化为必要时带前导零的两位数，即 00 - 60 （"60" 是支持闰秒所需的一个特殊值）。
 
    
 
    
 
     
'L'
 
     
秒中的毫秒，被格式化为必要时带前导零的三位数，即 000 - 999。
 
    
 
    
 
     
'N'
 
     
秒中的毫微秒，被格式化为必要时带前导零的九位数，即 000000000 - 999999999。
 
    
 
    
 
     
'p'
 
     
特定于语言环境的 上午或下午 标记以小写形式表示，例如 "am" 或 "pm"。使用转换前缀 'T' 可以强行将此输出转换为大写形式。
 
    
 
    
 
     
'z'
 
     
相对于 GMT 的 RFC 822 格式的数字时区偏移量，例如 -0800。
 
    
 
    
 
     
'Z'
 
     
表示时区缩写形式的字符串。Formatter 的语言环境将取代参数的语言环境（如果有）。
 
    
 
    
 
     
's'
 
     
自协调世界时 (UTC) 1970 年 1 月 1 日 00:00:00 至现在所经过的秒数，即 Long.MIN_VALUE/1000 与 Long.MAX_VALUE/1000 之间的差值。
 
    
 
    
 
     
'Q'
 
     
自协调世界时 (UTC) 1970 年 1 月 1 日 00:00:00 至现在所经过的毫秒数，即 Long.MIN_VALUE 与 Long.MAX_VALUE 之间的差值。
 
    
 
   
  
  
  
  


以下转换字符用来格式化日期：
  
  
  
  

   
   
   
   
 
    
 
     
'B'
 
     
特定于语言环境的月份全称，例如 "January" 和 "February"。
 
    
 
    
 
     
'b'
 
     
特定于语言环境的月份简称，例如 "Jan" 和 "Feb"。
 
    
 
    
 
     
'h'
 
     
与 'b' 相同。
 
    
 
    
 
     
'A'
 
     
特定于语言环境的星期几全称，例如 "Sunday" 和 "Monday"
 
    
 
    
 
     
'a'
 
     
特定于语言环境的星期几简称，例如 "Sun" 和 "Mon"
 
    
 
    
 
     
'C'
 
     
除以 100 的四位数表示的年份，被格式化为必要时带前导零的两位数，即 00 - 99
 
    
 
    
 
     
'Y'
 
     
年份，被格式化为必要时带前导零的四位数（至少），例如，0092 等于格里高利历的 92 CE。
 
    
 
    
 
     
'y'
 
     
年份的最后两位数，被格式化为必要时带前导零的两位数，即 00 - 99。
 
    
 
    
 
     
'j'
 
     
一年中的天数，被格式化为必要时带前导零的三位数，例如，对于格里高利历是 001 - 366。
 
    
 
    
 
     
'm'
 
     
月份，被格式化为必要时带前导零的两位数，即 01 - 13。
 
    
 
    
 
     
'd'
 
     
一个月中的天数，被格式化为必要时带前导零两位数，即 01 - 31
 
    
 
    
 
     
'e'
 
     
一个月中的天数，被格式化为两位数，即 1 - 31。
 
    
 
   
  
  
  
  


以下转换字符用于格式化常见的日期/时间组合。
  
  
  
  

   
   
   
   
 
    
 
     
'R'
 
     
24 小时制的时间，被格式化为 "%tH:%tM"
 
    
 
    
 
     
'T'
 
     
24 小时制的时间，被格式化为 "%tH:%tM:%tS"。
 
    
 
    
 
     
'r'
 
     
12 小时制的时间，被格式化为 "%tI:%tM:%tS %Tp"。上午或下午标记 ('%Tp') 的位置可能与语言环境有关。
 
    
 
    
 
     
'D'
 
     
日期，被格式化为 "%tm/%td/%ty"。
 
    
 
    
 
     
'F'
 
     
ISO 8601 格式的完整日期，被格式化为 "%tY-%tm-%td"。
 
    
 
    
 
     
'c'
 
     
日期和时间，被格式化为 "%ta %tb %td %tT %tZ %tY"，例如 "Sun Jul 20 16:17:00 EDT 1969"。