DecimalFormat使用心得

DecimalFormat使用心得 1 修改历史版本 修改历史 作者 描述 开发时间(h) 0.1 2007-8-12 LevinSoft 创建文档得基本结构、基本流程 1 2 介绍 本文对DecimalFormat类进行介绍和分析，主要包括：模式、特殊模式字符、科学计数法、舍入、阿拉伯数字、特殊值等。并且结合实际例子，说明它的使用上的一些方法和技巧。 3 基本概念 DecimalFormat 是 NumberFormat 的一个具体子类，用于格式化十进制数字。该类设计有各种功能，使其能够分析和格式化任意语言环境中的数，包括对西方语言、阿拉伯语和印度语数字的支持。它还支持不同类型的数，包括整数 (123)、定点数 (123.4)、科学记数法表示的数 (1.23E4)、百分数 (12%) 和金额 ($123)。所有这些内容都可以本地化。 要获取具体语言环境的 NumberFormat（包括默认语言环境），可调用 NumberFormat 的某个工厂方法，如 getInstance()。通常不直接调用 DecimalFormat 的构造方法，因为 NumberFormat 的工厂方法可能返回不同于 DecimalFormat 的子类。如果需要自定义格式对象，可执行： NumberFormat f = NumberFormat.getInstance(loc); if (f instanceof DecimalFormat) { ((DecimalFormat) f).setDecimalSeparatorAlwaysShown(true); }DecimalFormat 包含一个模式 和一组符号。可直接使用 applyPattern() 或间接使用 API 方法来设置模式。符号存储在 DecimalFormatSymbols 对象中。使用 NumberFormat 工厂方法时，可从已本地化的 ResourceBundle 中读取模式和符号。 3.1 模式 3.1.1 介绍 DecimalFormat 模式包含正数和负数子模式，例如 "#,##0.00;(#,##0.00)"。每个子模式都有前缀、数字部分和后缀。负数子模式是可选的；如果存在，则将用已本地化的减号（在多数语言环境中是 '-'）作为前缀的正数子模式用作负数子模式。也就是说，单独的 "0.00" 等效于 "0.00;-0.00"。如果存在显式的负数子模式，则它仅指定负数前缀和后缀；数字位数、最小位数，其他特征都与正数模式相同。这意味着 "#,##0.0#;(#)" 的行为与 "#,##0.0#;(#,##0.0#)" 完全相同。 分组分隔符通常用于千位，但是在某些国家中它用于分隔万位。分组大小是分组字符之间的固定数字位数，例如 100,000,000 是 3，而 1,0000,0000 则是 4。如果使用具有多个分组字符的模式，则最后一个分隔符和整数结尾之间的间隔才是使用的分组大小。所以 "#,##,###,####" == "######,####" == "##,####,####"。 3.1.2 实例 1．String val = new DecimalFormat("0.00").format(12); value is:12.00 2．String val = new DecimalFormat("990.05").format(12); value is:9912.05 特点： 1．可以设置默认输出的值。 2．0是特殊模式字符，没有数字填充时，默认填写0。使用场景： 1．在报表中，设置默认小数点后输出几位0的方式，。 3.2 特殊模式字符 3.2.1 介绍模式中的很多字符都是按字面解释的；在分析期间对其进行匹配，在格式化期间则不经改变地输出。另一方面，特殊字符代表了其他字符、字符串或字符类。如果要将其作为字面量出现在前缀或后缀中，那么除非另行说明，否则必须对其加引号。 下列字符用在非本地化的模式中。已本地化的模式使用从此 formatter 的 DecimalFormatSymbols 对象中获得的相应字符，这些字符已失去其特殊状态。两种例外是货币符号和引号，不将其本地化。 符号 位置 本地化？ 含义 0 数字 是 阿拉伯数字 # 数字字 是 阿拉伯数字，如果不存在则显示为空 . 数字 是 小数分隔符或货币小数分隔符 - 数字 是 减号 , 数字 是 分组分隔符 E 数字 是 分隔科学计数法中的尾数和指数。在前缀或后缀中无需加引号。 ; 子模式边界 是 分隔正数和负数子模式 % 前缀或后缀 是 乘以 100 并显示为百分数 /u2030 前缀或后缀 是 乘以 1000 并显示为千分数 ¤ (/u00A4) 前缀或后缀 否 货币记号，由货币符号替换。如果两个同时出现，则用国际货币符号替换。如果出现在某个模式中，则使用货币小数分隔符，而不使用小数分隔符。 ' 前缀或后缀 否 用于在前缀或或后缀中为特殊字符加引号，例如 "'#'#" 将 123 格式化为 "#123"。要创建单引号本身，请连续使用两个单引号："# o''clock"。 3.2.2 实例 1．String val = new DecimalFormat("0.##").format(12.5); System.out.println("value is:" + val); value is:12.5 2． String val = new DecimalFormat("0.###").format(12.57); System.out.println("value is:" + val); value is:12.57 特点： 1． ＃ 代表一位阿拉伯数字，如果不存在则显示为空场景： 1．在要求的显示长度确定下，比如：只允许整数或输出小数点后一位或两位，就可以设置0.##。 3.3 科学计数法科学计数法中的数表示为一个尾数和一个 10 的几次幂的乘积，例如可将 1234 表示为 1.234 x 10^3。尾数的范围通常是 1.0 <= x < 10.0，但并非必需如此。可指示 DecimalFormat 仅通过某个模式 来格式化和分析科学计数法表示的数；目前没有创建科学计数法格式的工厂方法。在这个模式中，指数字符后面紧跟着一个或多个数字字符即指示科学计数法。示例："0.###E0" 将数字 1234 格式化为 "1.234E3"。 指数字符后面的数字位数字符数给出了最小的指数位数。没有最大值。使用本地化的减号来格式化负数指数，不 使用模式中的前缀和后缀。这就允许存在诸如 "0.###E0 m/s" 等此类的模式。 最小和最大整数数字位数一起进行解释： 如果最大整数数字位数大于其最小整数数字位数并且大于 1，则强制要求指数为最大整数数字位数的倍数，并将最小整数数字位数解释为 1。最常见的用法是生成工程计数法，其中指数是 3 的倍数，如 "##0.#####E0"。使用此模式时，数 12345 格式化为 "12.345E3"，123456 则格式化为 "123.456E3"。 否则通过调整指数来得到最小整数数字位数。示例：使用 "00.###E0" 格式化 0.00123 时得到 "12.3E-4"。 尾数中的有效位数是最小整数 和最大小数 位数的和，不受最大整数位数的影响。例如，使用 "##0.##E0" 格式化 12345 得到 "12.3E3"。要显示所有位数，请将有效位数计数设置为零。有效位数不会影响分析。 指数模式可能不包含分组分隔符。 3.4 舍入 DecimalFormat 使用 half-even 舍入（请参阅 ROUND_HALF_EVEN）进行格式化。 实例： String val = new DecimalFormat("#0.0").format(12.08); System.out.println("value is:" + val); value is:12.1 3.5 阿拉伯数字为了进行格式化，DecimalFormat 使用 DecimalFormatSymbols 对象中所定义的、从已本地化的阿拉伯数字 0 开始的 10 个连续字符作为阿拉伯数字。为了进行分析，可识别 Character.digit所定义的这些阿拉伯数字和所有 Unicode 十进制阿拉伯数字。 3.6 特殊值 NaN 被格式化为单个字符，通常是 /uFFFD。此字符由 DecimalFormatSymbols 对象所确定。这是惟一不使用前缀和后缀的值。 无穷大的值被格式化为单个字符，通常是 /u221E，具有正数或负数前缀和后缀。无穷大值的字符由 DecimalFormatSymbols 对象所确定。 将负零（"-0"）分析为 如果 isParseBigDecimal() 为 true，则为 BigDecimal(0)， 如果 isParseBigDecimal() 为 false 并且 isParseIntegerOnly() 为 true，则为 Long(0)， 如果 isParseBigDecimal() 和 isParseIntegerOnly() 均为 false，则为 Double(-0.0)。 3.7 同步 DecimalFormat 通常不是同步的。建议为每个线程创建独立的格式实例。如果多个线程同时访问某个格式，则必须保持外部同步。 3.7.1 示例 // Print out a number using the localized number, integer, currency, // and percent format for each locale Locale[] locales = NumberFormat.getAvailableLocales(); double myNumber = -1234.56; NumberFormat form; for (int j=0; j<4; ++j) { System.out.println("FORMAT"); for (int i = 0; i < locales.length; ++i) { if (locales[i].getCountry().length() == 0) { continue; // Skip language-only locales } System.out.print(locales[i].getDisplayName()); switch (j) { case 0: form = NumberFormat.getInstance(locales[i]); break; case 1: form = NumberFormat.getIntegerInstance(locales[i]); break; case 2: form = NumberFormat.getCurrencyInstance(locales[i]); break;default: form = NumberFormat.getPercentInstance(locales[i]); break; } if (form instanceof DecimalFormat) { System.out.print(": " + ((DecimalFormat) form).toPattern()); } System.out.print(" -> " + form.format(myNumber)); try { System.out.println(" -> " + form.parse(form.format(myNumber)));} catch (ParseException e) {} } }4 总结和展望 a) 简单的总结前面知识 b) 今后的提高部分 5 参考资料 6 术语和附录