Java工具包中的Formatter类

向右看齐 2022-05-16 09:42 317阅读 0赞

# 本文目录 #

1 Formatter类

2 格式化说明符

3 其它相关方法

# 1 Formatter类 #

## 1.1 使用方法 ##

Formatter formatter = new Formatter(\[destination\]);

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

## 1.2 使用说明 ##

**（1）Formatter构造参数：**

若无参数，格式化后的字符串会被存放在一个内部的StringBuffer中，此后，可通过formatter.toString()方法返回格式化后的字符串。

// 无参数构造Formatter对象 
       Formatter formatter = new Formatter(); 
       // 格式化操作 
       formatter.format( "The result number is %d.", 7); 
       // 获得格式化后的字符串 
       String str = formatter.toString(); 
       // 控制台输出内容：The result number is 7. 
       System.out.println(str);

若有参数，该参数表示要输出的目标位置，可以是一个StringBuffer对象，一个文件，或一个数据流，此后，格式化的字符串将直接输出到指定位置。

// 构造Formatter对象并指向标准输出流 
       Formatter formatter = new Formatter(System.out); 
       // 格式化并输出到指定位置（控制台输出内容：The result number is 7.） 
       formatter.format( "The result number is %d.", 7);

**（2）format方法参数：**

String format

是一个包含格式化说明符的字符串，该字符串指定了整体目标格式，通过格式化说明符进行占位并指定相应位置的内容格式；

Object… args

表示多个参数对象，其内容将依次对应format中的占位符（格式化说明符），根据指定的内容格式填充到指定位置，从而形成一个满足要求的字符串。

# 2 格式化说明符 #

## 2.1 格式 ##

%\[argument\_index$\]\[flags\]\[width\]\[.precision\]conversion

## 2.2 格式说明 ##

（1）argument\_index$：指定对应的内容参数位置，默认按照顺序依次对应。

（2）flags：格式控制。

（3）width：区域宽度。

（4）.precision：对于浮点型数据，表示显示的小数位数；对于字符串数据，表示显示的字符数量。

（5）conversion：类型转换字符。

## 2.3 格式控制(flags) ##

<table> 
 <tbody> 
  <tr> 
   <th>符号</th> 
   <th>作用</th> 
   <th>示例</th> 
   <th>效果</th> 
  </tr> 
 </tbody> 
 <tbody> 
  <tr> 
   <td>无负号</td> 
   <td>右对齐</td> 
   <td>formatter.format(“<strong><em>%8d</em></strong>“, 1000);</td> 
   <td><strong>* &nbsp; &nbsp;1000*</strong></td> 
  </tr> 
  <tr> 
   <td>有负号“-”</td> 
   <td>左对齐</td> 
   <td>formatter.format(“<strong><em>%-8d</em></strong>“, 1000);</td> 
   <td><strong><em>1000 &nbsp; &nbsp;</em></strong></td> 
  </tr> 
  <tr> 
   <td>有加号“+”</td> 
   <td>正数前显示正号<br> 负数前显示负号</td> 
   <td>formatter.format(“<strong><em>%+8d</em></strong>“, 1000);<br> formatter.format(“<strong><em>%+8d</em></strong>“, -1000);</td> 
   <td><strong>* &nbsp; +1000*</strong><br> <strong>* &nbsp; -1000*</strong></td> 
  </tr> 
  <tr> 
   <td>有空格“ ”</td> 
   <td>正数前显示空格<br> 负号前显示负号</td> 
   <td>formatter.format(“<strong><em>% 8d</em></strong>“, 1000);<br> formatter.format(“<strong><em>% 8d</em></strong>“, -1000);</td> 
   <td><strong>* &nbsp; &nbsp;1000*</strong><br> <strong>* &nbsp; -1000*</strong></td> 
  </tr> 
  <tr> 
   <td>有零“0”</td> 
   <td>使用0填充剩余位置</td> 
   <td>formatter.format(“<strong><em>%08d</em></strong>“, 1000);</td> 
   <td><strong><em>00001000</em></strong></td> 
  </tr> 
  <tr> 
   <td>有逗号“,”</td> 
   <td>每3位数字添加一个逗号</td> 
   <td>formatter.format(“<strong><em>%,8d</em></strong>“, 1000);</td> 
   <td><strong>* &nbsp; 1,000*</strong></td> 
  </tr> 
 </tbody> 
</table>

## 2.4 类型转换字符 ##

<table> 
 <tbody> 
  <tr> 
   <th>符号</th> 
   <th>类型</th> 
   <th>示例</th> 
   <th>效果</th> 
  </tr> 
 </tbody> 
 <tbody> 
  <tr> 
   <td>d</td> 
   <td>整数型（十进制）</td> 
   <td>formatter.format(“%d”, 1000);</td> 
   <td>1000</td> 
  </tr> 
  <tr> 
   <td>o</td> 
   <td>整数型（八进制）</td> 
   <td>formatter.format(“%o”, 1000);</td> 
   <td>1750</td> 
  </tr> 
  <tr> 
   <td>x</td> 
   <td>整数型（十六进制）</td> 
   <td>formatter.format(“%x”, 1000);</td> 
   <td>3e8</td> 
  </tr> 
  <tr> 
   <td>f</td> 
   <td>浮点型（十进制）</td> 
   <td>formatter.format(“%f”, 1000.0);</td> 
   <td>1000.000000</td> 
  </tr> 
  <tr> 
   <td>e</td> 
   <td>浮点型（科学计数）</td> 
   <td>formatter.format(“%e”, 1000.0);</td> 
   <td>1.000000e+03</td> 
  </tr> 
  <tr> 
   <td>b</td> 
   <td>布尔型</td> 
   <td>formatter.format(“%b”, true);</td> 
   <td>true</td> 
  </tr> 
  <tr> 
   <td>c</td> 
   <td>字符型</td> 
   <td>formatter.format(“%c”, ‘A’);</td> 
   <td>A</td> 
  </tr> 
  <tr> 
   <td>s</td> 
   <td>字符串型</td> 
   <td>formatter.format(“%s”, “String”);</td> 
   <td>String</td> 
  </tr> 
  <tr> 
   <td>%</td> 
   <td>字符“%”</td> 
   <td>formatter.format(“%d%%”, 100);</td> 
   <td>100%</td> 
  </tr> 
 </tbody> 
</table>

## 2.5 时间类型转换字符 ##

<table> 
 <tbody> 
  <tr> 
   <th>符号</th> 
   <th>类型</th> 
   <th>示例</th> 
   <th>效果</th> 
  </tr> 
 </tbody> 
 <tbody> 
  <tr> 
   <td>tC</td> 
   <td>上世纪</td> 
   <td>formatter.format(“%tC”, calendar);</td> 
   <td>20</td> 
  </tr> 
  <tr> 
   <td>tY</td> 
   <td>年（4位）</td> 
   <td>formatter.format(“%tY”, calendar);</td> 
   <td>2017</td> 
  </tr> 
  <tr> 
   <td>ty</td> 
   <td>年（2位）</td> 
   <td>formatter.format(“%ty”, calendar);</td> 
   <td>17</td> 
  </tr> 
  <tr> 
   <td>tm</td> 
   <td>月</td> 
   <td>formatter.format(“%tm”, calendar);</td> 
   <td>11</td> 
  </tr> 
  <tr> 
   <td>tB</td> 
   <td>月份</td> 
   <td>formatter.format(“%tB”, calendar);</td> 
   <td>November</td> 
  </tr> 
  <tr> 
   <td>tb</td> 
   <td>月份缩写</td> 
   <td>formatter.format(“%tb”, calendar);</td> 
   <td>Nov</td> 
  </tr> 
  <tr> 
   <td>td</td> 
   <td>日（2位）</td> 
   <td>formatter.format(“%td”, calendar);</td> 
   <td>20</td> 
  </tr> 
  <tr> 
   <td>te</td> 
   <td>日</td> 
   <td>formatter.format(“%te”, calendar);</td> 
   <td>20</td> 
  </tr> 
  <tr> 
   <td>tA</td> 
   <td>星期</td> 
   <td>formatter.format(“%tA”, calendar);</td> 
   <td>Monday</td> 
  </tr> 
  <tr> 
   <td>ta</td> 
   <td>星期（缩写）</td> 
   <td>formatter.format(“%ta”, calendar);</td> 
   <td>Mon</td> 
  </tr> 
  <tr> 
   <td>tH</td> 
   <td>小时（24小时制）（2位）</td> 
   <td>formatter.format(“%tH”, calendar);</td> 
   <td>18</td> 
  </tr> 
  <tr> 
   <td>tk</td> 
   <td>小时（24小时制）</td> 
   <td>formatter.format(“%tk”, calendar);</td> 
   <td>18</td> 
  </tr> 
  <tr> 
   <td>tI</td> 
   <td>小时（12小时制）（2位）</td> 
   <td>formatter.format(“%tI”, calendar);</td> 
   <td>06</td> 
  </tr> 
  <tr> 
   <td>tl</td> 
   <td>小时（12小时制）</td> 
   <td>formatter.format(“%tl”, calendar);</td> 
   <td>6</td> 
  </tr> 
  <tr> 
   <td>tM</td> 
   <td>分钟</td> 
   <td>formatter.format(“%tM”, calendar);</td> 
   <td>10</td> 
  </tr> 
  <tr> 
   <td>tS</td> 
   <td>秒</td> 
   <td>formatter.format(“%tS”, calendar);</td> 
   <td>22</td> 
  </tr> 
  <tr> 
   <td>tL</td> 
   <td>毫秒</td> 
   <td>formatter.format(“%tL”, calendar);</td> 
   <td>490</td> 
  </tr> 
  <tr> 
   <td>tN</td> 
   <td>微秒</td> 
   <td>formatter.format(“%tN”, calendar);</td> 
   <td>570000000</td> 
  </tr> 
  <tr> 
   <td>tp</td> 
   <td>上午/下午</td> 
   <td>formatter.format(“%tp”, calendar);</td> 
   <td>pm</td> 
  </tr> 
  <tr> 
   <td>tz</td> 
   <td>时区</td> 
   <td>formatter.format(“%tz”, calendar);</td> 
   <td>+0800</td> 
  </tr> 
  <tr> 
   <td>tZ</td> 
   <td>时区（缩写）</td> 
   <td>formatter.format(“%tZ”, calendar);</td> 
   <td>CST</td> 
  </tr> 
  <tr> 
   <td>ts</td> 
   <td>自1970-01-01 00:00的秒数</td> 
   <td>formatter.format(“%ts”, calendar);</td> 
   <td>1511172687</td> 
  </tr> 
  <tr> 
   <td>tQ</td> 
   <td>自1970-01-01 00:00的毫秒数</td> 
   <td>formatter.format(“%tQ”, calendar);</td> 
   <td>1511172687297</td> 
  </tr> 
  <tr> 
   <td>tF</td> 
   <td>YYYY-MM-DD</td> 
   <td>formatter.format(“%tF”, calendar);</td> 
   <td>2017-11-20</td> 
  </tr> 
  <tr> 
   <td>tD</td> 
   <td>MM/DD/YY</td> 
   <td>formatter.format(“%tD”, calendar);</td> 
   <td>11/20/17</td> 
  </tr> 
  <tr> 
   <td>tR</td> 
   <td>HH:MM（24小时制）</td> 
   <td>formatter.format(“%tR”, calendar);</td> 
   <td>18:11</td> 
  </tr> 
  <tr> 
   <td>tT</td> 
   <td>HH:MM:SS（24小时制）</td> 
   <td>formatter.format(“%tT”, calendar);</td> 
   <td>18:11:27</td> 
  </tr> 
  <tr> 
   <td>tr</td> 
   <td>HH:MM:SS 上午/下午</td> 
   <td>formatter.format(“%tr”, calendar);</td> 
   <td>06:11:27 pm</td> 
  </tr> 
  <tr> 
   <td>tc</td> 
   <td>星期 月 日 HH:MM:SS YYYY</td> 
   <td>formatter.format(“%tc”, calendar);</td> 
   <td>Mon Nov 20 18:11:27 CST 2017</td> 
  </tr> 
 </tbody> 
</table>

# 3 其它相关方法 #

## 3.1 String.format方法 ##

该方法内部，实际上也是通过Formatter类进行格式化，然后，将格式化后的字符串返回，其内部代码如下：

public static String format(String format, Object... args) { 
       return new Formatter().format(format, args).toString(); 
       }

## 3.2 System.out.format方法 ##

该方法内部，也是通过Formatter类进行格式化，然后，将格式化后的字符串直接输出到System.out输出流，其内部代码如下：

public PrintStream format(String format, Object ... args) { 
       try { 
       synchronized ( this) { 
       ensureOpen(); 
       if ((formatter == null) 
       || (formatter.locale() != Locale.getDefault())) 
       formatter = new Formatter((Appendable) this); 
       formatter.format(Locale.getDefault(), format, args); 
       } 
       } catch (InterruptedIOException x) { 
       Thread.currentThread().interrupt(); 
       } catch (IOException x) { 
       trouble = true; 
       } 
       return this; 
       }