Class Formatter

該類提供了對布局調(diào)整和對齊的支持，對數(shù)字、字符串和日期/時間數(shù)據(jù)的常用格式，以及本地特定的輸出。支持常見的Java類型，如byte、BigDecimal和Calendar。通過Formattable接口為任意的用戶類型提供有限的格式化定制。
格式化器對于多線程訪問不一定安全。線程安全是可選的。

舉例說明：

StringBuilder sb = new StringBuilder();
   // Send all output to the Appendable object sb
   Formatter formatter = new Formatter(sb, Locale.US);
   // 顯示參數(shù)索引可用于重新排序輸出。
   formatter.format("%4$2s %3$2s %2$2s %1$2s", "a", "b", "c", "d")
   // -> " d  c  b  a"
   // 可選作為第一個參數(shù)的語言環(huán)境可用于獲取特定于語言環(huán)境的數(shù)字格式?？梢越o出精度和寬度，以便對數(shù)值進行舍入與對齊。
   formatter.format(Locale.FRANCE, "e = %+10.4f", Math.E);
   // -> "e =    +2,7183"
   // '(' 數(shù)字標志可用于用小括號而不是減號來格式化負數(shù)。 組別分隔符會自動插入。
   formatter.format("Amount gained or lost since last statement: $ %(,.2f",
                    balanceDelta);
   // -> "Amount gained or lost since last statement: $ (6,217.58)"

如以下調(diào)用所示，存在用于常見格式化請求的便捷方法：

 // 寫一個格式化的字符串到 System.out.
   System.out.format("Local time: %tT", Calendar.getInstance());
   // -> "Local time: 13:34:18"

   // 將格式化的輸出寫到 System.err.
   System.err.printf("Unable to open file '%1$s': %2$s",
                     fileName, exception.getMessage());
   // -> "Unable to open file 'food': No such file or directory"

像 C語言的sprintf(3)，字符串可以使用靜態(tài)方法格式化String.format：

 // 格式化一個包含日期的字符串
   import java.util.Calendar;
   import java.util.GregorianCalendar;
   import static java.util.Calendar.*;

   Calendar c = new GregorianCalendar(1995, MAY, 23);
   String s = String.format("Duke's Birthday: %1$tb %1$te, %1$tY", c);
   // -> s == "Duke's Birthday: May 23, 1995"

*每個產(chǎn)生格式化輸出的方法都需要一個格式字符串和一個參數(shù)列表。

格式字符串是一個String可能包含固定文本和一個或多個嵌入格式說明符的字符串。

https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Formatter.html#syntax

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

此格式字符串是該format方法的第一個參數(shù)。它包含三個格式說明符“%1$tm”、“%1$te”和“%1$tY”，它們指示應(yīng)如何處理參數(shù)以及應(yīng)在文本中插入的位置。格式字符串的其余部分是固定文本"Dukes Birthday: "，包括任何其他空格或標點符號。參數(shù)列表包含在格式字符串之后傳遞給方法的所有參數(shù)。

通用、字符和數(shù)字類型的格式說明符具有以下語法：

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

可選的argument_index是一個十進制的整數(shù)，表示參數(shù)在參數(shù)列表中的位置。第一個參數(shù)用 "1$"引用，第二個用 "2$"引用，等等。

可選的flags是一組用于修改輸出格式的字符。有效標志的集合取決于轉(zhuǎn)換的情況。

可選的width是一個正的十進制整數(shù)，表示要寫入輸出的最小字符數(shù)。

可選的precision是一個非負的十進制整數(shù)，通常用于限制字符的數(shù)量。具體行為取決于轉(zhuǎn)換的情況。

所需的conversion是一個字符，表示參數(shù)應(yīng)該如何被格式化。一個給定參數(shù)的有效轉(zhuǎn)換集取決于該參數(shù)的數(shù)據(jù)類型。

• 用于表示日期和時間的類型的格式說明符具有以下語法：

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

可選的argument_index、flags和width定義如上。

所需的conversion是兩個字符序列。第一個字符是't'或'T'。第二個字符表示要使用的格式。這些字符與 GNUdate和 POSIXstrftime(3c)定義的字符相似但不完全相同。

與參數(shù)不對應(yīng)的格式說明符具有以下語法：

• %[flags][width]conversion

可選flags和width定義如上。

所需的conversion是指示要在輸出中插入的內(nèi)容的字符。

conversion

conversion分為以下幾類：

• 一般- 可應(yīng)用于任何參數(shù)類型
• 字符- 可應(yīng)用于表示 Unicode 字符的基本類型：char、Character、byte、Byte、short和Short. 這種轉(zhuǎn)換也可以應(yīng)用于類型int和Integer當Character.isValidCodePoint(int)返回true時
• 數(shù)字

  Integral - 可以應(yīng)用于 Java 整數(shù)類型：byte, Byte, short, Short, intand Integer, long, Long, and BigInteger（但不是char或者 Character）

  浮點- 可應(yīng)用于 Java 浮點類型： float、Float、double、Double和BigDecimal

• 日期/時間- 可應(yīng)用于能夠編碼日期或時間的 Java 類型：long、Long、Calendar和 DateTemporalAccessor
• 百分比- 產(chǎn)生字面的'%' ( '\u0025')
• 行分隔符 - 生成特定于平臺的行分隔符

對于類別General、Character、Numberic、Integral和Date/Time轉(zhuǎn)換，除非另有說明，否則如果參數(shù)arg為null，則結(jié)果為 "null"。

日期/時間轉(zhuǎn)換

以下日期和時間轉(zhuǎn)換后綴字符是定義給't','T'-這兩個conversion的。

以下轉(zhuǎn)換字符用于格式化時間：

以下轉(zhuǎn)換字符用于格式化日期：

以下轉(zhuǎn)換字符用于格式化常見的日期/時間組合。

任何未明確定義為日期/時間轉(zhuǎn)換后綴的字符都是非法的，并為將來的擴展保留。

Flags

1取決于 Formattable的定義。

2僅用于'd'conversion。

3僅適用于'o'、'x'和'X'conversion。

4對于'd','o','x', 和'X'conversions應(yīng)用于BigInteger或'd'應(yīng)用于byte,Byte,short,Short,int和Integer,long, 和Long。

5僅適用于'e'、'E'、'f'、'g'和'G'conversion。

任何未明確定義為標志的字符都是非法的，并為將來的擴展保留。

到此這篇關(guān)于Java格式字符串的使用的文章就介紹到這了,更多相關(guān)Java格式字符串內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論