JDK5新特性:格式化输出

DK5.0允许象C语言那样直接用printf()方法来格式化输出,并且提供了许多参数来格式化输入,调用也很简单:


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类也提供了更完善的方法来格式化,例如:


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

 

 

对时间的格式化用字母t来代表,通常在t后面加上特殊的字符来显示时间的某个部分:


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.

 

 



格式字符串的语法

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

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

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

 

可选的 argument_index 是一个十进制整数,用于表明参数在参数列表中的位置。第一个参数由 "1$" 引用,第二个参数由 "2$" 引用,依此类推。

可选的 flags 是修改输出格式的字符集。有效标志的集合取决于转换类型。

可选 width 是一个非负十进制整数,表明要向输出中写入的最少字符数。

可选 precision 是一个非负十进制整数,通常用来限制字符数。特定行为取决于转换类型。

所需的 conversion 是一个表明应该如何格式化参数的字符。给定参数的有效转换集合取决于参数的数据类型。

用来表示日期和时间类型的格式说明符的语法如下:

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

 

可选的 argument_index、flags 和 width 的定义同上。

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

与参数不对应的格式说明符的语法如下:

   %[flags][width]conversion

 

可选 flags 和 width 的定义同上。

所需的 conversion 是一个表明要在输出中所插内容的字符。

转换

转换可分为以下几类:

常规 - 可应用于任何参数类型

字符 - 可应用于表示 Unicode 字符的基本类型:char、Character、byte、Byte、short 和 Short。当 Character.isValidCodePoint(int) 返回 true 时,可将此转换应用于 int 和 Integer 类型

数值

整数 - 可应用于 Java 的整数类型:byte、Byte、short、Short、int、Integer、long、LongBigInteger

浮点 - 可用于 Java 的浮点类型:float、Float、double、DoubleBigDecimal

日期/时间 - 可应用于 Java 的、能够对日期或时间进行编码的类型:long、LongCalendarDate

百分比 - 产生字面值 '%' ('/u0025')

行分隔符 - 产生特定于平台的行分隔符

下表总结了受支持的转换。由大写字符(如 'B'、'H'、'S'、'C'、'X'、'E'、'G'、'A' 和 'T')表示的转换与由相应的小写字符的转换等同,根据流行的 Locale 规则将结果转换为大写形式除外。后者等同于 String.toUpperCase() 的以下调用

    out.toUpperCase()


转换


参数类别


说明


'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' 转换定义的。这些类型相似于但不完全等同于那些由 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"。

任何未明确定义为转换的字符都是非法字符,并且都被保留,以供将来扩展使用。

标志

下表总结了受支持的标志。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' 转换。

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

宽度

宽度是将向输出中写入的最少字符数。对于行分隔符转换,不适用宽度,如果提供宽度,则会抛出异常。

精度

对于常规参数类型,精度是将向输出中写入的最多字符数。

对于浮点转换 'e'、'E' 和 'f',精度是小数点分隔符后的位数。如果转换是 'g' 或 'G',那么精度是舍入计算后所得数值的所有位数。如果转换是 'a' 或 'A',则不必指定精度。

对于字符、整数和日期/时间参数类型转换,以及百分比和行分隔符转换,精度是不适用的;如果提供精度,则会抛出异常。

参数索引

参数索引是一个十进制整数,用于表明参数在参数列表中的位置。第一个参数由 "1$" 引用,第二个参数由 "2$" 引用,依此类推。

根据位置引用参数的另一种方法是使用 '<' ('/u003c') 标志,这将会重用以前格式说明符的参数。例如,以下两条语句产生的字符相同:

   Calendar c = ...;

   String s1 = String.format("Duke's Birthday: %1$tm %1$te,%1$tY", c);

   String s2 = String.format("Duke's Birthday: %1$tm %<$te,%<$tY", c);

 

 

时间: 2024-08-30 18:17:56

JDK5新特性:格式化输出的相关文章

01-java基础加强,eclipse工具使用,快捷键,断点调试,单元测试,jdk5新特性,增强for循环,集合map,list,可变参数,枚举,反射,泛型

一.eclipse工具的使用 1. java代码的位置        1) 选择工作空间 workspace  选择一个文件夹存放程序(代码) 不要用中文和空格        2) 新建一个java 工程(Project)        3) 建包建类   2. 快捷键        alt + / :代码自动补齐,需要配置的               打开preferences(首选项), 搜keys,打开快捷键配置面板               搜 alt+/ ,取消绑定        

JDK5新特性之新的格式化输出

JDK5.0允许象C语言那样直接用printf()方法来格式化输出,并且提供了许多参数来格式化输入,调用也很简单: 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的实例. Pr

Asp.Net 4.0新特性,输出更纯净的Html代码 ClientIDMode,ViewStateMode等

1. 在Asp.Net 4.0 中我们可以控制输出html中的对象id的形式了,之前我们 常常看到类似这样的id ctl00_MainContent_txtAutoID 这在客户端控制时很不方便,也没有多少实质的意义 现在我们可以通过设置控件的ClientIDMode修改clientId的输出形式,例如下 面代码: 1 <asp:TextBox ID="txtPredictable" runat="server" ClientIDMode="Pred

JDK5新特性---注解学习笔记(一)

1.注解(也被称为元数据):为我们在代码中添加信息提供了一种形式化的方法,使我们可以在稍后某个时刻非常方便的使用这些数据.   2.  javaSE内置了3种标准注解: @Override       表示当前的方法定义将覆盖超类中的方法.如果你不小心拼写错误,或者方法签名对不上被覆盖的方法,编译器就会发出错误的提示. @Deprecated   如果程序员使用了注解为它的元素,那么编译器会发出警告信息. @SuppressWarnings   关闭不当的编译器警告信息.         在我们

JDK5.0新特性系列---6.格式化输出

import java.util.Date;   /**  * 使用printf输出  */ /**关键技术点  * 使用java.io.PrintStream的printf方法实现C风格的输出  * printf 方法的第一个参数为输出的格式,第二个参数是可变长的,表示待输出的数据对象  */ public class Printf {          public static void main(String[] args) {               /*** 输出字符串 ***/

JDK5.0新特性系列---目录

  JDK5.0新特性系列---目录   JDK5.0新特性系列---1.自动装箱和拆箱   JDK5.0新特性系列---2.新的for循环 JDK5.0新特性系列---3.枚举类型 JDK5.0新特性系列---4.静态导入 JDK5.0新特性系列---5.可变长参数Varargs JDK5.0新特性系列---6.格式化输出 JDK5.0新特性系列---7.使用ProcessBuilder执行本地命令 JDK5.0新特性系列---8.泛型编程 JDK5.0新特性系列---9.注释功能Annota

.NET 4新特性:表、SEO及可扩展输出缓存

图表控件 微软向开发者提供了大量可免费下载的图表控件,可以在.NET 3.5 ASP.NET 或WinForms项目中使用这些控件.要想在Visual Studio 2008中使用这些控件则 需要安装一个插件,该插件提供了VS工具箱及智能集成功能.现在这些控件已经 集成到了.NET 4.0中,这样就无需再去下载额外的插件了.Samples Environment for MS Chart Controls提供了这些控件的使用示例. ASP.NET 4 SEO 微软发布了一个SEO Toolkit

ThinkPHP3.1新特性之内容解析输出详解_php实例

以往版本的ThinkPHP中页面输出的过程是读取模板文件,然后进行模板解析(也支持调用第三方模板引擎解析),但是有一些情况,我们并没有定义模板文件,或者把模板文件保存在数据库里面,那么这种情况下进行页面输出的时候,我们是无法进行模板文件读取的,ThinkPHP3.1版本则针对这样的情况增加了内容解析输出的功能. 内置的模板引擎也进行了完善,如果传入的模板文件不存在的话,则会认为是传入的模板解析内容,因此,ThinkPHP3.1版的View类和Action类也做了一些相应的改进. display方

ThinkPHP3.1新特性之对页面压缩输出的支持_php实例

目前大多数浏览器都已经支持页面的压缩输出,通过压缩输出,页面大小可以减少30%,但是由于3.0及以前的版本都没有内置页面压缩输出功能,所以一般来说,开发人员需要自己在入口文件中添加: ob_start('ob_gzhandler'); 但是由于服务器环境的不同,有时候这个配置会和php.ini文件中的zlib压缩配置冲突.而ThinkPHP3.1版则内置了页面压缩输出的功能,不再需要再手动添加ob_gzhandler代码,增加OUTPUT_ENCODE配置参数,并支持检测zlib.output_