JAVA字符串类型-String.format()函数用法

来源:互联网 发布:mac os x 10.6.8 编辑:程序博客网 时间:2024/04/30 18:15
Static String format(String format, Object... args)

该函数为静态类型,可直接使用。

format 参数为要使用的格式,而args为需要被格式化的参数。

format参数的选择和C语言中sprintf()方法的输出格式参数类似。

Java中IO包里PrintWriter类的

printf(Locale l, String format, Object... args)

printf(String format, Object... args) 

方法也支持格式化参数。

一般格式化参数形式为%[index$][标志][最小宽度] [转换方式]

显式索引 [index$]是在格式说明符中包含参数索引时使用。参数索引是一个十进制整数,用于指示参数在参数列表中的位置。第一个参数由 "1$" 引用,第二个参数由 "2$" 引用,依此类推。可以多次引用任何一个参数。

格式字符串语法

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


应该注意标志和转换方式的不同

例子:

private static String lpad(int length, int number) {        String f = "%0" + length + "d";        return String.format(f, number);}
以上是一个格式化流水号函数。可以对number参数进行格式化,在其前添加0


标志

下表总结了受支持的标志。y 表示该标志受指示参数类型支持。

标志常规字符整数浮点日期/时间说明'-'yyyyy结果将是左对齐的。'#'y1-y3y-结果应该使用依赖于转换类型的替换形式'+'--y4y-结果总是包括一个符号'  '--y4y-对于正值,结果中将包括一个前导空格'0'--yy-结果将用零来填充','--y2y5-结果将包括特定于语言环境的组分隔符'('--y4y5-结果将是用圆括号括起来的负数
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' 转换。


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



转换

转换可分为以下几类:

  1. 常规 - 可应用于任何参数类型
  2. 字符 - 可应用于表示 Unicode 字符的基本类型:charCharacterbyteByteshort 和 Short。当 Character.isValidCodePoint(int) 返回 true 时,可将此转换应用于 int 和 Integer 类型
  3. 数值
    1. 整数 - 可应用于 Java 的整数类型:byteByteshortShortintIntegerlongLong 和 BigInteger
    2. 浮点 - 可用于 Java 的浮点类型:floatFloatdoubleDouble 和 BigDecimal
  4. 日期/时间 - 可应用于 Java 的、能够对日期或时间进行编码的类型:longLongCalendar 和 Date
  5. 百分比 - 产生字面值 '%' ('\u0025')
  6. 行分隔符 - 产生特定于平台的行分隔符

下表总结了受支持的转换。


转换参数类别说明'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' 转换定义的。

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

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



0 0