JDK1.5中,String類新增了一個很有用的靜態方法String.format(): format(Locale l, String format, Object... args) 使用指定的語言環境、格式字符串和參數返回一個格式化字符串。 format(String format, Object... args) 使用指定的格式字符串和參數返回一個格式化字符串。 舉幾個這個方法實用的例子(註釋是輸出結果):
CODE:
long now = System.currentTimeMillis(); String s = String.format("%tR", now); // "15:12"
CODE:
// Current month/day/year Date d = new Date(now); s = String.format("%tD", d); // "07/13/04"
CODE:
s = String.format("%,d", Integer.MAX_VALUE); // "2,147,483,647"
CODE:
s = String.format("%05d", 123); // "00123"
是不是很方便,讓人動心啊?哈哈,還有更多的效果! 其實format函數有些類似c語言中printf函數,一些格式字符串與 C 類似,但已進行了某些定製,以適應 Java 語言,並且利用了其中一些特性。此方法提供了對佈局對齊和排列的支持,以及對數值、字符串和日期/時間數據的常規格式和特定於語言環境的輸出的支持。支持諸如 byte、BigDecimal 和 Calendar 等常見 Java 類型。 產生格式化輸出的每個方法都需要格式字符串 和參數列表。格式字符串是一個 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 組成。 1.常規類型、字符類型和數值類型的格式說明符的語法如下:%[argument_index$][flags][width][.precision]conversion 可選的 argument_index 是一個十進制整數,用於表明參數在參數列表中的位置。第一個參數由 "1$" 引用,第二個參數由 "2$" 引用,依此類推。可選的 flags 是修改輸出格式的字符集。有效標誌的集合取決於轉換類型。可選 width 是一個非負十進制整數,表明要向輸出中寫入的最少字符數。可選 precision 是一個非負十進制整數,通常用來限制字符數。特定行爲取決於轉換類型。所需的 conversion 是一個表明應該如何格式化參數的字符。給定參數的有效轉換集合取決於參數的數據類型。 2.用來表示日期和時間類型的格式說明符的語法如下: %[argument_index$][flags][width]conversion 可選的 argument_index、flags 和 width 的定義同上。所需的 conversion 是一個由兩字符組成的序列。第一個字符是 't' 或 'T'。第二個字符表明所使用的格式。這些字符類似於但不完全等同於那些由 GNU date 和 POSIX strftime(3c) 定義的字符。 3.與參數不對應的格式說明符的語法如下: %[flags][width]conversion 可選 flags 和 width 的定義同上。所需的 conversion 是一個表明要在輸出中所插內容的字符。 轉換 轉換可分爲以下幾類: 1. 常規 - 可應用於任何參數類型 2. 字符 - 可應用於表示 Unicode 字符的基本類型:char、Character、byte、Byte、short 和 Short。當 Character.isValidCodePoint(int) 返回 true 時,可將此轉換應用於 int 和 Integer 類型 3. 數值 1. 整數 - 可應用於 Java 的整數類型:byte、Byte、short、Short、int、Integer、long、Long 和 BigInteger 2. 浮點 - 可用於 Java 的浮點類型:float、Float、double、Double 和 BigDecimal 4. 日期/時間 - 可應用於 Java 的、能夠對日期或時間進行編碼的類型:long、Long、Calendar 和 Date。 5. 百分比 - 產生字面值 '%' ('/u0025') 6. 行分隔符 - 產生特定於平臺的行分隔符 下表總結了受支持的轉換。由大寫字符(如 'B'、'H'、'S'、'C'、'X'、'E'、'G'、'A' 和 'T')表示的轉換與由相應的小寫字符的轉換等同,根據流行的 Locale 規則將結果轉換爲大寫形式除外。後者等同於 String.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' | 行分隔符 | 結果爲特定於平臺的行分隔符 |
'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 | - | 結果將是用圓括號括起來的負數 |
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);