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"
。
- 如果最大整数数字位数大于其最小整数数字位数并且大于 1,则强制要求指数为最大整数数字位数的倍数,并将最小整数数字位数解释为 1。最常见的用法是生成工程计数法,其中指数是 3 的倍数,如
- 尾数中的有效位数是最小整数 和最大小数 位数的和,不受最大整数位数的影响。例如,使用
"##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)
。
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 术语和附录