有時會想把數字,日期,字符串按照給定規則給格式化。SUN JDK 為我們提供了這個API,它是java.util.Formatter。此類提供了對布局對齊和排列的支持,以及
對數值、字符串和日期/時間數據的常規格式和特定于語言環境的輸出的支持。
如何格式化?
給定規則:
要想按照自己的想法格式化必須事先編寫一個規則。那這個規則要怎么編寫?
1.常規類型、字符類型和數值類型的格式說明符的語法如下:
%[argument_index$][flags][width][.precision]conversion
2.用來表示日期和時間類型的格式說明符的語法如下:
%[argument_index$][flags][width]conversion
3.與參數不對應的格式說明符的語法如下:
%[flags][width]conversion
API中有這樣三種規則,很顯然第一個規則的內容是最全面的。其它規則的內容和第一規則的內容有重復,那單說第一規則內容,其它規則依次類推。
注意:規則一中的precision前面要加英文句號“.”
API有以下解釋:
可選的 argument_index 是一個十進制整數,用于表明參數在參數列表中的位置。第一個參數由 "1$" 引用,第二個參數由 "2$" 引用,依此類推。
可選 flags 是修改輸出格式的字符集。有效標志集取決于轉換類型。
可選 width 是一個非負十進制整數,表明要向輸出中寫入的最少字符數。
可選 precision 是一個非負十進制整數,通常用來限制字符數。特定行為取決于轉換類型。
所需 conversion 是一個表明應該如何格式化參數的字符。給定參數的有效轉換集取決于參數的數據類型。
argument_index很好理解,就是一參數占位符,用來表示要被格式化的參數。
flags
標志 | 常規 | 字符 | 整數 | 浮點 | 日期/時間 | 說明 |
'-' | 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' 轉換。
任何未顯式定義為標志的字符都是非法字符,并且都被保留,以供擴展使用。
width 就表示一最少字符數,被格式化參數用precision 截取器截取后與width 相比,被格式化參數字符數如果小于width ,則加字符則到等于width 。如果大于則width 不起作用。所以可以叫width 為少加多過器。
precision 在上面也提到了,precision 是一個截取器,用于截取被格式化參數。
conversion 轉換可分為以下幾類:
常規- 可應用于任何參數類型
字符- 可應用于表示 Unicode 字符的基本類型:char、Character、byte、Byte、short 和 Short。當 Character.isValidCodePoint(int) 返回 true 時,可將此轉換應用于 int 和 Integer 類型
數值
1 整數- 可應用于 Java 的整數類型:byte、Byte、short、Short、int、Integer、long、Long 和 BigInteger
2 浮點- 可用于 Java 的浮點類型:float、Float、double、Double 和 BigDecimal
日期/時間- 可應用于 Java 的、能夠對日期或時間進行編碼的類型:long、Long、Calendar 和 Date。
百分比- 產生字面值 '%' ('\u0025')
行分隔符- 產生特定于平臺的行分隔符
常規 | 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 | 日期和時間轉換字符的前綴 |
百分比 | % | 結果為字面值 '%' |
行分隔符 | n | 結果為特定于平臺的行分隔符 |
常出現的異常
java.util.IllegalFormatConversionException: d != java.lang.Double : 被格式化參數類型與規則轉換類型不對應。
java.util.FormatFlagsConversionMismatchException: Conversion = d, Flags = # : flag不適用于規則轉換類型。
Formatter類是用正則表達式驗證給定規則的
正則表達式如下:
private static final String formatSpecifier
=
"%(\\d+\\$)?([-#+0,(\\<]*)?(\\d+)?(\\.\\d+)?([tT])?([a-zA-Z%])";
總結:
- 最重要的是它可以格式化日期/時間,數值和字符。
- 可以把日期轉換成年,月,日,星期等。可以為數值填充空格或0,添加分組字符,正負號,及小括號。我們可以在System.out.format (),String.format()方法中直接應用Formatter類。