java.text.DecimalFormat

原文：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));    }}

输出：

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

每一个子 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));    }}

输出：

0.000.00

DecimalFormat 可以直接解析字符串：

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

输出：

1515115.26262

可以看到，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));    }}

输出：

656,5232,3265.63656,5232,3265.63656,5232,3265.63

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) {}     } }