JAVA String.format 方法

 

		//number
		System.out.println(String.format("%d", 2));// 2
		System.out.println(String.format("%05d", 2));// 00002
		System.out.println(String.format("%-5d", 23));// 23
		System.out.println(String.format("%d% d% d", 10, 20, -30));// 10 20-30
		System.out.println(String.format("%,d", 23235345));// 23,235,345
		System.out.println(String.format("%(d", 2));// 2
		System.out.println(String.format("%(d", -2));// (2)
		System.out.println(String.format("%+d", -2));// -2
		System.out.println(String.format("%o", 200));// 310
		System.out.println(String.format("%x", 200));// c8
		System.out.println(String.format("%#o", 200));// 0310
		System.out.println(String.format("%#x", 200));// 0xc8
		System.out.println(String.format("%e", 3.13124));// 3.131240e+00
		System.out.println(String.format("%f", 3.13124));// 3.131240
		System.out.println(String.format("%.3f", 3.13124));// 3.131
		System.out.println(String.format("%g", 3.13124));// 3.13124
		System.out.println(String.format("%g", 3234234.2343));// 3.23423e+06
		System.out.println(String.format("%a", 3.13124));// 0x1.90cc78e9f6a94p1
		System.out.println(String.format("%c", 'a'));// a
		System.out.println(String.format("%s%c", "b ", 'a'));// b a
		System.out.println(String.format("%d%%", 12));// 12%
		System.out.println(String.format("%.2f%%", 12.2344));// 12.23%

		//date
		Date date = new Date();
		System.out.println(String.format("%tR", System.currentTimeMillis())); //15:29  
		System.out.println(String.format("%tT", date)); //15:29:58  
		System.out.println(String.format("%tr", date)); //03:29:58 下午  
		System.out.println(String.format("%tD", date)); //03/31/14  
		System.out.println(String.format("%tF", date)); //2014-03-31  
		System.out.println(String.format("%tc", date)); //星期一 三月 31 15:29:58 CST 2014  
		System.out.println(String.format("%1$tF %1$tT", date)); //2014-03-31 17:36:50
		System.out.println(String.format("%1$tY-%1$tm-%1$td %1$tH:%1$tM:%1$tS", date)); //2014-03-31 17:36:50
		String dateFmt = "今天是%1$tY年%1$tm月%1$td日%1$tH时%1$tM分%1$tS秒";
		System.out.println(String.format(dateFmt, date)); //今天是2014年03月31日18时03分46秒

		//array
		Object[] objs = new Object[4];
		objs[0] = "Today is";
		objs[1] = new Date();
		String str3 = String.format("%s %tF.", (Object[]) objs);
		System.out.println(str3); //Today is 2014-03-31.

 

 

JDK1.5中，String类新增了一个很有用的静态方法String.format(): 

format(Locale l, String format, Object... args) 使用指定的语言环境、格式字符串和参数返回一个格式化字符串。 
format(String format, Object... args) 使用指定的格式字符串和参数返回一个格式化字符串。

举几个这个方法实用的例子(注释是输出结果)： 
CODE: 
long now = System.currentTimeMillis();

String s = String.format("%tR", now);   // "15:12" 
CODE: 
// Current month/day/year

Date d = new Date(now);

s = String.format("%tD", d);                // "07/13/04" 
CODE: 
s = String.format("%,d", Integer.MAX_VALUE); // "2,147,483,647" 
CODE: 
s = String.format("%05d", 123);              // "00123"是不是很方便，让人动心啊？哈哈，还有更多的效果!

其实format函数有些类似c语言中printf函数，一些格式字符串与 C 类似，但已进行了某些定制，以适应 Java 语言，并且利用了其中一些特性。此方法提供了对布局对齐和排列的支持，以及对数值、字符串和日期/时间数据的常规格式和特定于语言环境的输出的支持。支持诸如 byte、BigDecimal 和 Calendar 等常见 Java 类型。

产生格式化输出的每个方法都需要格式字符串 和参数列表。格式字符串是一个 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 组成。

1.常规类型、字符类型和数值类型的格式说明符的语法如下：

%[argument_index$][flags][width][.precision]conversion

      可选的 argument_index 是一个十进制整数，用于表明参数在参数列表中的位置。第一个参数由 "1$" 引用，第二个参数由 "2$" 引用，依此类推。 
      可选的 flags 是修改输出格式的字符集。有效标志的集合取决于转换类型。  

      可选 width 是一个非负十进制整数，表明要向输出中写入的最少字符数。 
      可选 precision 是一个非负十进制整数，通常用来限制字符数。特定行为取决于转换类型。 
      所需的 conversion 是一个表明应该如何格式化参数的字符。给定参数的有效转换集合取决于参数的数据类型。

2.用来表示日期和时间类型的格式说明符的语法如下: 
%[argument_index$][flags][width]conversion

可选的 argument_index 、flags 和 width 的定义同上。 
所需的 conversion 是一个由两字符组成的序列。第一个字符是 't' 或 'T'。第二个字符表明所使用的格式。这些字符类似于但不完全等同于那些由 GNU date 和 POSIX strftime(3c) 定义的字符。

3.与参数不对应的格式说明符的语法如下： 
%[flags][width]conversion

可选 flags 和 width 的定义同上。 
所需的 conversion 是一个表明要在输出中所插内容的字符。

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

 

        System.out.println(String.format("%2$08d", -3123,-5566));   //-0005566
        System.out.println(String.format("%1$9d", -31));  //      -31
        System.out.println(String.format("%1$-9d", -31));  //-31      
        System.out.println(String.format("%1$(9d", -31));  //     (31)
        System.out.println(String.format("%1$#9x", 5689));  //   0x1639
        System.out.println(String.format("%1$.2f", 5689.0)); //5689.00
          
        //格式化的位置  
        String str = "I love u %s, you love me %s"; 
        String str2 = "I love u %2$s, you love me %1$s"; 
        System.out.println(String.format(str, "a","b")); //I love u a, you love me b
        System.out.println(String.format(str2, "a","b")); //I love u b, you love me a
          
        //数组的操作  
        Object[] sendData = new Object[4];  
        sendData[0] = Integer.valueOf(1);  
        sendData[1] = "172.12.1.2";  
        sendData[2] = Integer.valueOf(123);  
        sendData[3] = "test";  
        String sendDataString = String.format("%d,%s,%d,%s",(Object[]) sendData);  
        System.out.println(sendDataString);  //1,172.12.1.2,123,test

 

 

1.对整数进行格式化：%[index$][标识][最小宽度]转换方式

        我们可以看到，格式化字符串由4部分组成，其中%[index$]的含义我们上面已经讲过，[最小宽度]的含义也很好理解，就是最终该整数转化的字符串最少包含多少位数字。我们来看看剩下2个部分的含义吧：

 

 

标识： 

'-'    在最小宽度内左对齐，不可以与“用0填充”同时使用

'#'    只适用于8进制和16进制，8进制时在结果前面增加一个0，16进制时在结果前面增加0x

'+'    结果总是包括一个符号（一般情况下只适用于10进制，若对象为BigInteger才可以用于8进制和16进制）

'  '    正值前加空格，负值前加负号（一般情况下只适用于10进制，若对象为BigInteger才可以用于8进制和16进制）

'0'    结果将用零来填充

','    只适用于10进制，每3位数字之间用“，”分隔

'('    若参数是负数，则结果中不添加负号而是用圆括号把数字括起来（同‘+’具有同样的限制）

 

转换方式：

d-十进制   o-八进制   x或X-十六进制        上面的说明过于枯燥，我们来看几个具体的例子。需要特别注意的一点是：大部分标识字符可以同时使用。 

 

 

        System.out.println(String.format("%1$,09d", -3123));
        System.out.println(String.format("%1$9d", -31));
        System.out.println(String.format("%1$-9d", -31));
        System.out.println(String.format("%1$(9d", -31));
        System.out.println(String.format("%1$#9x", 5689));

 

 

 

//结果为：

//-0003,123

//      -31

//-31      

//     (31)

//   0x1639

 

2.对浮点数进行格式化：%[index$][标识][最少宽度][.精度]转换方式

        我们可以看到，浮点数的转换多了一个“精度”选项，可以控制小数点后面的位数。 

 

标识： 

'-'    在最小宽度内左对齐，不可以与“用0填充”同时使用

'+'    结果总是包括一个符号

'  '    正值前加空格，负值前加负号

'0'    结果将用零来填充

','    每3位数字之间用“，”分隔（只适用于fgG的转换）

'('    若参数是负数，则结果中不添加负号而是用圆括号把数字括起来（只适用于eEfgG的转换）

 

转换方式：

'e', 'E'  --  结果被格式化为用计算机科学记数法表示的十进制数

'f'          --  结果被格式化为十进制普通表示方式

'g', 'G'    --  根据具体情况，自动选择用普通表示方式还是科学计数法方式

'a', 'A'    --   结果被格式化为带有效位数和指数的十六进制浮点数

 

3.对字符进行格式化：

        对字符进行格式化是非常简单的，c表示字符，标识中'-'表示左对齐，其他就没什么了。

 

4.对百分比符号进行格式化：

        看了上面的说明，大家会发现百分比符号“%”是特殊格式的一个前缀。那么我们要输入一个百分比符号该怎么办呢？肯定是需要转义字符的,但是要注意的是，在这里转义字符不是“\”，而是“%”。换句话说，下面这条语句可以输出一个“12%”：

System.out.println(String.format("%1$d%%", 12));

 

5.取得平台独立的行分隔符：

        System.getProperty("line.separator")可以取得平台独立的行分隔符，但是用在format中间未免显得过于烦琐了。于是format函数自带了一个平台独立的行分隔符那就是String.format("%n")。

 

6.对日期类型进行格式化：

         以下日期和时间转换的后缀字符是为 't' 和 'T' 转换定义的。这些类型相似于但不完全等同于那些由 GNU date 和 POSIX strftime(3c) 定义的类型。提供其他转换类型是为了访问特定于 Java 的功能（如将 'L' 用作秒中的毫秒）。

 

以下转换字符用来格式化时间：

'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"。 

 

 

		System.out.println(String.format("%1tR", System.currentTimeMillis())); //15:29
		System.out.println(String.format("%1tT", new Date())); //15:29:58
		System.out.println(String.format("%1tr", new Date())); //03:29:58 下午
		System.out.println(String.format("%1tD", new Date())); //03/31/14
		System.out.println(String.format("%1tF", new Date())); //2014-03-31
		System.out.println(String.format("%1tc", new Date())); //星期一 三月 31 15:29:58 CST 2014
		System.out.println(String.format("%tF %tT", new Date(), new Date())); //2014-03-31 15:36:16