JDK5新特性：格式化输出

System.out.format("Pi is approximately  %f", Math.Pi);

   System.out.printf("Pi is approximately  %f", Math.Pi);

 printf()和 format() 方法具有相同的功能. System.out 是 java.io.PrintStream的实例. PrintStream, java.io.PrintWriter, 和 java.lang.String 每个类都有四个新的格式化方法:

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

printf( String format, Object... args);

format( Locale locale, String format, Object... args);

printf( Locale locale, String format, Object... args);

formatter.format("Pi is approximately %1$f," +

        "and e is about %2$f", Math.PI, Math.E);

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

其中：

argument_index是一个正整数，说明了参数的位置，1为取第一个参数

width表示输出的最小字母个数

precision代表数字的小数位数

conversion代表被格式化的参数的类型：

f  float,

t  time

d  decimal

o octal

x  hexadecimal

s  general

c  a Unicode character

package format;

   import java.util.Formatter;

   public class UsingFormatter {

     public static void main(String[] args) {

       if (args.length != 1) {

         System.err.println("usage: " +

           "java format/UsingFormatter ");

         System.exit(0);

       }

       String format = args[0];

       StringBuilder stringBuilder = new StringBuilder();

       Formatter formatter = new Formatter(stringBuilder);

       formatter.format("Pi is approximately " + format +

         ", and e is about " + format, Math.PI, Math.E);

       System.out.println(stringBuilder);

     }

   }

//控制台调用

java format/UsingFormatter %f

//输出

Pi is approximately 3.141593, and e is about 2.718282

//控制台调用

java format/UsingFormatter %.2f

//输出

Pi is approximately 3.14, and e is about 2.72

//控制台调用

java format/UsingFormatter %6.2f

//输出(有空格来填补长度)

Pi is approximately   3.14, and e is about   2.72

//控制台调用

java format/UsingFormatter  %1$.2f

//输出

Pi is approximately 3.14, and e is about 3.14

//改变区域设置

package format;

   import java.util.Formatter;

   import java.util.Locale;

   public class UsingFormatter {

     public static void main(String[] args) {

       if (args.length != 1) {

         System.err.println("usage: " +

           "java format/UsingFormatter <format string>");

         System.exit(0);

       }

       String format = args[0];

       StringBuilder stringBuilder = new StringBuilder();

       Formatter formatter = new Formatter(stringBuilder,

                                   Locale.FRANCE);

       formatter.format("Pi is approximately " + format +

         ", and e is about " + format, Math.PI, Math.E);

       System.out.println(stringBuilder);

     }

   }

//控制台调用

java format/UsingFormatter %.2f

//输出

Pi is approximately 3,14, and e is about 2,72

//采用format,printf的可替代写法

package format;

   public class UsingSystemOut {

     public static void main(String[] args) {

       if (args.length != 1) {

         System.err.println("usage: " +

           "java format/UsingSystemOut <format string>");

         System.exit(0);

       }

       String format = args[0];

       System.out.format("Pi is approximately " + format +

         ", and e is approximately " + format, Math.PI, Math.E);

     }

   }

//控制台调用

java format/UsingSystemOut %.2f%n

//输出

Pi is approximately 3.14

   , and e is about 2.72

tr  hour and minute,

tA  the day of the week

tB  the name of the month

te  the number of the day of the month

tY  the year

//eg.

package format;

   import java.util.Calendar;

   public class FormattingDates  {

     public static void main(String[] args) {

       System.out.printf("Right now it is %tr on " +

                         "%<tA, %<tB %<te, %<tY.%n",

                         Calendar.getInstance());

     }

   }

//说明：“<”指示采用的参数为前一个被格式化的参数

//输出

Right now it is 01:55:19 PM on Wednesday, September 22, 2004.

转换

参数类别

说明

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

行分隔符

结果为特定于平台的行分隔符

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

标志

常规

字符

整数

浮点

日期/时间

说明

'-'

y

y

y

y

y

结果将是左对齐的。

'#'

y1

-

y3

y

-

结果应该使用依赖于转换类型的替换形式

'+'

-

-

y4

y

-

结果总是包括一个符号

'  '

-

-

y4

y

-

对于正值，结果中将包括一个前导空格

'0'

-

-

y

y

-

结果将用零来填充

','

-

-

y2

y5

-

结果将包括特定于语言环境的组分隔符

'('

-

-

y4

y5

-

结果将是用圆括号括起来的负数