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

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

 

评论

8 楼 jimode2013 2013-07-09  

很不错，感谢了

7 楼 haoweishow 2013-04-24  

实用，谢谢啦

6 楼 SE_XiaoFeng 2013-04-24  

还是没有理解，这个String.format()方法的真正作用是什么?

5 楼 Redpick13 2013-03-27  

刚好看完java API，前面一部分正好是它的翻译，楼主辛苦

4 楼 xiaofengfay 2011-08-04  

看不懂  与C#里一样么

3 楼 v韧竹v 2011-01-13  

 

2 楼 guji528 2010-03-10  

很实用，对创建字符序列很有帮助

1 楼 yegaofei 2010-01-04  

很实用，谢谢！！