创新互联鸿蒙OS教程：鸿蒙OSFormatter

Formatter

成都创新互联专注为客户提供全方位的互联网综合服务，包含不限于成都网站设计、成都网站制作、外贸网站建设、皮山网络推广、小程序开发、皮山网络营销、皮山企业策划、皮山品牌公关、搜索引擎seo、人物专访、企业宣传片、企业代运营等，从售前售中售后，我们都将竭诚为您服务，您的肯定，是我们最大的嘉奖；成都创新互联为所有大学生创业者提供皮山建站搭建服务，24小时服务热线：18982081108，官方网址：www.cdcxhl.com

java.lang.Object

|---java.util.Formatter

public final class Formatter
extends Object
implements Closeable, Flushable

printf 样式格式字符串的解释器。 此类提供对布局对齐和对齐、数字、字符串和日期/时间数据的通用格式以及特定于语言环境的输出的支持。 支持常见的 Java 类型，例如 byte、BigDecimal 和 Calendar。 通过 Formattable 接口为任意用户类型提供有限的格式定制。

格式化程序对于多线程访问不一定是安全的。 线程安全是可选的，并且是此类中方法的用户的责任。

Java 语言的格式化打印很大程度上受到 C 的 printf 的启发。 尽管格式字符串与 C 相似，但已进行了一些定制以适应 Java 语言并利用其某些特性。 此外，Java 格式比 C 更严格； 例如，如果转换与标志不兼容，则会引发异常。 在 C 中，不适用的标志会被默默地忽略。 因此，格式字符串旨在为 C 程序员识别，但不一定与 C 中的格式字符串完全兼容。

预期用法示例：

   StringBuilder sb = new StringBuilder();
   // Send all output to the Appendable object sb
   Formatter formatter = new Formatter(sb, Locale.US);


   // Explicit argument indices may be used to re-order output.
   formatter.format("%4$2s %3$2s %2$2s %1$2s", "a", "b", "c", "d")
   // -> " d  c  b  a"


   // Optional locale as the first argument can be used to get
   // locale-specific formatting of numbers.  The precision and width can be
   // given to round and align the value.
   formatter.format(Locale.FRANCE, "e = %+10.4f", Math.E);
   // -> "e =    +2,7183"


   // The '(' numeric flag may be used to format negative numbers with
   // parentheses rather than a minus sign.  Group separators are
   // automatically inserted.
   formatter.format("Amount gained or lost since last statement: $ %(,.2f",
                    balanceDelta);
   // -> "Amount gained or lost since last statement: $ (6,217.58)"

如以下调用所示，存在用于常见格式化请求的便捷方法：

   // Writes a formatted string to System.out.
   System.out.format("Local time: %tT", Calendar.getInstance());
   // -> "Local time: 13:34:18"


   // Writes formatted output to 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) 一样，可以使用静态方法 String#format(String,Object...) 格式化字符串：

   // Format a string containing a date.
   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"

组织

本规范分为两部分。 第一部分，摘要，涵盖了基本的格式化概念。 本部分适用于希望快速入门并熟悉其他编程语言的格式化打印的用户。 第二部分，详细信息，涵盖了具体的实现细节。 它适用于想要更精确地规范格式化行为的用户。

概括

本节旨在提供格式化概念的简要概述。

格式化字符串语法

每个产生格式化输出的方法都需要一个格式字符串和一个参数列表。 格式字符串是一个可以包含固定文本和一个或多个嵌入格式说明符的字符串。 考虑以下示例：

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

此格式字符串是格式方法的第一个参数。 它包含三个格式说明符“%1$tm”、“%1$te”和“%1$tY”，它们指示应如何处理参数以及应在文本中插入的位置。 格式字符串的其余部分是固定文本，包括“公爵生日：”和任何其他空格或标点符号。 参数列表包含在格式字符串之后传递给方法的所有参数。 在上面的示例中，参数列表的大小为 1，由日历对象 c 组成。

• 通用、字符和数字类型的格式说明符具有以下语法：

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

可选的 argument_index 是一个十进制整数，指示参数在参数列表中的位置。 第一个参数由“1$”引用，第二个由“2$”引用，以此类推。

可选标志是一组修改输出格式的字符。 有效标志集取决于转换。

可选宽度是一个十进制正整数，指示要写入输出的最小字符数。

可选精度是一个非负十进制整数，通常用于限制字符数。 具体行为取决于转换。

所需的转换是一个字符，指示应如何格式化参数。 给定参数的有效转换集取决于参数的数据类型。

• 用于表示日期和时间的类型的格式说明符具有以下语法：

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

可选的参数索引、标志和宽度定义如上。

所需的转换是两个字符序列。 第一个字符是“t”或“T”。 第二个字符表示要使用的格式。 这些字符与 GNU date 和 POSIX strftime(3c) 定义的字符相似但不完全相同。

• 与参数不对应的格式说明符具有以下语法：

     %[flags][width]conversion 

可选标志和宽度定义如上。

所需的转换是指示要在输出中插入的内容的字符。

转换

转换分为以下几类：

1. 一般 - 可应用于任何参数类型

1. 字符 - 可应用于表示 Unicode 字符的基本类型：char、Character、byte、Byte、short 和 Short。 当 Character#isValidCodePoint 返回 true 时，这种转换也可以应用于 int 和 Integer 类型

1. 数字

• Integral - 可应用于 Java 整数类型：byte、Byte、short、Short、int 和 Integer、long、Long 和 BigInteger（但不是 char 或 Character）

• 浮点 - 可应用于 Java 浮点类型：float、Float、double、Double 和 BigDecimal

1. 日期/时间 - 可应用于能够编码日期或时间的 Java 类型：long、Long、Calendar、Date 和 TemporalAccessor

1. 百分比 - 产生一个文字 '%' ('\u0025')

1. Line Separator - 生成特定于平台的行分隔符

下表总结了支持的转换。 由大写字符表示的转换（即“B”、“H”、“S”、“C”、“X”、“E”、“G”、“A”和“T”）是相同的 与对应的小写转换字符相同，只是根据当前 Locale 的规则将结果转换为大写。 结果等效于以下对 String#toUpperCase() 的调用

    out.toUpperCase() 

任何未明确定义为转换的字符都是非法的，并为将来的扩展保留。

日期/时间转换

为“t”和“T”转换定义了以下日期和时间转换后缀字符。 这些类型与 GNU date 和 POSIX strftime(3c) 定义的类型相似但不完全相同。 提供了其他转换类型来访问特定于 Java 的功能（例如，“L”表示秒内的毫秒）。

以下转换字符用于格式化时间：

以下转换字符用于格式化日期：

以下转换字符用于格式化常见的日期/时间组合。

任何未明确定义为日期/时间转换后缀的字符都是非法的，并为将来的扩展保留。

标志

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

1. 取决于 Formattable 的定义。
2. 仅用于“d”转换。

1. 仅适用于“o”、“x”和“X”转换。

1. 对于应用于 BigInteger 的 'd'、'o'、'x' 和 'X' 转换或应用于 byte、Byte、short、Short、int 和 Integer、long 和 Long 的 'd'。

1. 仅适用于“e”、“E”、“f”、“g”和“G”转换。

任何未明确定义为标志的字符都是非法的，并为将来的扩展保留。

宽度

宽度是要写入输出的最小字符数。 对于行分隔符转换，宽度不适用； 如果提供，将抛出异常。

精确

对于一般参数类型，精度是要写入输出的最大字符数。

对于浮点转换“a”、“A”、“e”、“E”和“f”，精度是小数点后的位数。 如果转换为“g”或“G”，则精度是舍入后结果幅度中的总位数。

对于字符、整数和日期/时间参数类型以及百分比和行分隔符转换，精度不适用； 如果提供了精度，则会抛出异常。

参数索引

参数索引是一个十进制整数，指示参数在参数列表中的位置。 第一个参数由“1$”引用，第二个由“2$”引用，以此类推。

按位置引用参数的另一种方法是使用 '<' ('\u003c') 标志，这会导致重新使用前一个格式说明符的参数。 例如，以下两个语句将产生相同的字符串：

   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 %

    out.toUpperCase() 

     formatter.format("%4$s %3$s %2$s %1$s %4$s %3$s %2$s %1$s",
                      "a", "b", "c", "d")
     // -> "d c b a d c b a"

      formatter.format("%s %s % "a b b b"
      // "c" and "d" are ignored because they are not referenced

     formatter.format("%s %s %s %s", "a", "b", "c", "d")
     // -> "a b c d"

   formatter.format("%2$s %s % "b a a b"
   // "c" and "d" are ignored because they are not referenced

   Formatter f = new Formatter();
   f.format("Last reboot at %tc", lastRebootDate);
   String s = f.toString();
   // -> s == "Last reboot at Sat Jan 01 00:00:00 PST 2000"

     out().toString()