Java String.Format() 方法及参数说明

文章：http://blueram.iteye.com/blog/441683

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. 行分隔符 - 产生特定于平台的行分隔符

 

 Double d = 12.3366;

         System.out.println(String.format("%2$08d", -3123,-5566));
         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));

         //小数点后面两位
         System.out.println(String.format("%1$.2f", 5689.0)); //必须是同类型的才能进行转换

         //格式化的位置
         /*String str = "I love ni %s, you love me %s";
         String str2 = "I love ni %2$s, you love me %1$s";

         System.out.println(String.format(str, "renjunjie","songliyu"));

         System.out.println(String.format(str2, "renjunjie","songliyu"));*/


         //数组的操作
         Object[] sendData = new Object[4];
         sendData[0] = Integer.valueOf(1);
         sendData[1] = "172.12.1.2";
         sendData[2] = Integer.valueOf(123);
         sendData[3] = "testadfaerfa";
         String sendDataString = String.format("%d,%s,%d,%s",(Object[]) sendData);
         System.out.println(sendDataString);