java.text.DecimalFormat

青叶i生活 2018-05-02

展开全文

原文：https://docs.oracle.com/javase/7/docs/api/java/text/DecimalFormat.html

简要

DecimalFormat 的 pattern 都包含着正负子 pattern ，例如 “#,##0.00;(#,##0.00)”：

/**
 * Created by Shuai on 2016/7/11.
 */
public class Main {
    public static void main(String[] args) {

        // 正值
        BigDecimal bigDecimal = BigDecimal.valueOf(-12211151515151.541666);

        // 负值
        BigDecimal bigDecimal2 = BigDecimal.valueOf(12211151515151.541666);
        String pattern = "#,##0.00;(#,##0.00)";
        DecimalFormat decimalFormat = new DecimalFormat(pattern);
        decimalFormat.format(bigDecimal);
        System.out.println(decimalFormat.format(bigDecimal));
        System.out.print(decimalFormat.format(bigDecimal2));
    }
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

输出：

(12,211,151,515,151.54)
12,211,151,515,151.541
2

每一个子 pattern 都由前缀，数值部分和后缀组成，像上面的正负 pattern 只能是前缀和后缀不同, 数值部分默认取正 pattern 的,这就意味着 "#,##0.0#;(#)" 就等同与 "#,##0.0#;(#,##0.0#)"。；后面的负pattern是可选的，可以没有，如果没有，负值会以默认的形式显示（在大多数地区前缀是“-”），例如 -12,211,151,515,151.54。有趣的是对于 0 值，都会取正 pattern:

public class Main {
    public static void main(String[] args) {

        BigDecimal bigDecimal = BigDecimal.valueOf(-0.00);
        BigDecimal bigDecimal2 = BigDecimal.valueOf(0.00);
        String pattern = "0.00;(0.00)";
        DecimalFormat decimalFormat = new DecimalFormat(pattern);
        decimalFormat.format(bigDecimal);
        System.out.println(decimalFormat.format(bigDecimal));
        System.out.print(decimalFormat.format(bigDecimal2));
    }
}1
2
3
4
5
6
7
8
9
10
11
12

输出：

0.00
0.001
2

DecimalFormat 可以直接解析字符串：

System.out.print(decimalFormat.parse(",,,1,515,115.26262", new ParsePosition(0)));1

输出：

1515115.262621

可以看到，decimalFormat.parse 方法都自动去掉了.之前的，，这里要注意的是，解析的字符串第一个字符必须是数字，或者，后紧跟着数字，否则会抛出异常或者解析为null。parse 的第二个参数指定了解析的第一个字符的位置，上面的例子位置 0,1,2,3 都是从1开始解析，4,5都是从5开始解析，即如果取，位则由后面紧挨着的数字补位。如果.前面出现了除，和数字外其他的字符则parse解析到这个字符的前一位，或者.后面出现了除数字外的其他字符（包括,）则pares 解析到这个字符的前一位。

如果 pattern 包含多组个数不同的字符，例如："#,##,###,####",那它使用的是组后一组，即"#,##,###,####" == "######,####" == "##,####,####"：

public class Main {
    public static void main(String[] args) {

        BigDecimal bigDecimal = BigDecimal.valueOf(65652323265.626262);
        String pattern = "#,##,###,###0.00";
        String pattern2 = "######,###0.00";
        String pattern3 = "##,####,###0.00";
        DecimalFormat decimalFormat = new DecimalFormat(pattern);
        System.out.println(decimalFormat.format(bigDecimal));
        decimalFormat.applyPattern(pattern2);
        System.out.println(decimalFormat.format(bigDecimal));
        decimalFormat.applyPattern(pattern3);
        System.out.println(decimalFormat.format(bigDecimal));
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

输出：

656,5232,3265.63
656,5232,3265.63
656,5232,3265.631
2
3

Special Pattern Characters

符号	位置	本地化	含义
0	数值部分	是	数字，是0也显示
#	数值部分	是	数字，如果是0则不显示（仅限开始和小数点后的末尾位置）
.	数值部分	是	十进制分隔符或货币十进制分隔符（分隔符不能有多个）
-	数值部分	是	负号
,	数值部分	是	分组分隔符
E	数值部分	是	科学记数法分离尾数和指数。不需要引用前缀或后缀
;	正负Pattern之间	是	区分正负Pattern
%	前缀，后缀	是	数值乘以100，并以百分比显示
\u2030	前缀，后缀	是	乘以1000,显示千分比
¤ (\u00A4)	前缀，后缀	否	货币符，由货币符号替换。如果是连续的两个符号（例：`¤¤`），则由国际货币符号替换
‘	前缀，后缀	否	用于显示特殊字符，例如：”’#’#” ，会格式化123为 `#123`，两个单引号放一起，就可以显示一个单引号,例如：””##.00\u00A4”，格式化 33.33 为 `'33.33￥`

科学计数法

1234 可以表示为 1.234 x 10^3，pattern 为 “0.###E0”，就会把 1234 格式化为 1.234E3。
整数的个数
- 如果整数位的最大个数大于最小个数而且大于1,就会强制指数是整数位最大个数的倍数，整数位最小个数视为1。例如：”##0.#####E0”，整数为最大个数是3，最小个数是1，则指数必须是3的倍数，而且，最小要有1位整数。12345 格式化为 “12.345E3”, 123456 格式化为 “123.456E3”, 123 格式化为 “123E0”（整数位必须至少有1位，且不能是0，指数为3的倍数）。
- 否则，由整数的最小个数来调整指数，”00.###E0” 格式化 0.00123 为”12.3E-4”。
有效数字个数由整数位的最小个数与小数位的最大个数之和得出，例如 “##0.##E0” 整数位最小个数为1，小数位最大个数为2，则有效个数是3，格式化 12345 为 “12.3E3”。除有效个数外，其他省略。

数值舍入规则

可以通过方法 decimalFormat.setRoundingMode 来设置 RoundingMode，默认使用的是 RoundingMode.HALF_EVEN.

它不同步，如果多线程访问，要自己实现同步

建议为每个线程创建单独的格式实例。如果多个线程同时访问一个格式,它必须在外部同步。

Example

// 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) {}
     }
 }1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31