DecimalFormat的用法介绍

import java.text.*;
import java.util.*;

public class DecimalFormatSample {
public static void main(String args[]) {
   DecimalFormat myformat1 = new DecimalFormat("###,###.0000");//使用系统默认的格式
   System.out.println(myformat1.format(111111123456.12));

   Locale.setDefault(Locale.US);
   DecimalFormat myformat2 = new DecimalFormat("###,###.0000");//使用美国的格式
   System.out.println(myformat2.format(111111123456.12));

   //----------------------------also use applypattern------------------------------//

   DecimalFormat myformat3 = new DecimalFormat();
   myformat3.applyPattern("##,###.000");
   System.out.println(myformat3.format(11112345.12345));
//-----------------控制指数输出-------------------------------------------------//

      DecimalFormat myformat4 = new DecimalFormat();
   myformat4.applyPattern("0.000E0000");
   System.out.println(myformat4.format(10000));
   System.out.println(myformat4.format(12345678.345));
//------------------百分数的输出-------------------------------------------//
/*      DecimalFormat是NumberFormat的一个子类,其实例被指定为特定的地区。因此，你可以使用NumberFormat.getInstance 指定一个地区，
然后将结构强制转换为一个DecimalFormat对象。文档中提到这个技术可以在大多情况下适用，但是你需要用try/catch 块包围强制转换以防转
换不能正常工作 (大概在非常不明显得情况下使用一个奇异的地区)。     */
        DecimalFormat myformat5 = null;
   try{
       myformat5 = (DecimalFormat)NumberFormat.getPercentInstance();
   }catch(ClassCastException e)
   {
    System.err.println(e); 
   }
   myformat5.applyPattern("00.0000%");
   System.out.println(myformat5.format(0.34567));
   System.out.println(myformat5.format(1.34567));

       

}

/*---------------------------------运行结果-------------------------------------------//
F:\2004-04-12>java DecimalFormatSample
111,111,123,456.1200
111,111,123,456.1200
11,112,345.123
1.000E0004
1.235E0007
34.5670%
134.5670%

*/

}

  ==============================================================================

 

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 中读取模式和符号。

模式

DecimalFormat 模式具有下列语法：

模式：
正数模式
正数模式；负数模式
正数模式：
前缀opt 数字后缀opt
负数模式：
前缀opt 数字后缀opt
前缀：
除 \uFFFE、\uFFFF 和特殊字符以外的所有 Unicode 字符
后缀：
除 \uFFFE、\uFFFF 和特殊字符以外的所有 Unicode 字符
数字：
整数指数opt
整数。小数指数opt
整数：
最小整数
         #
# 整数
# , 整数
最小整数：
         0
0 最小整数
0 , 最小整数
小数：
最小小数opt 可选小数opt
最小小数：
0 最小小数opt
可选小数：
# 可选小数opt
指数：
E 最小指数
最小指数：
0 最小指数opt

DecimalFormat 模式包含正数和负数子模式，例如 "#,##0.00;(#,##0.00)"。每个子模式都有前缀、数字部分和后缀。负数子模式是可选的；如果存在，则将用已本地化的减号（在多数语言环境中是 '-'）作为前缀的正数子模式用作负数子模式。也就是说，单独的 "0.00" 等效于 "0.00;-0.00"。如果存在显式的负数子模式，则它仅指定负数前缀和后缀；数字位数、最小位数，其他特征都与正数模式相同。这意味着 "#,##0.0#;(#)" 的行为与 "#,##0.0#;(#,##0.0#)" 完全相同。

用于无穷大值、数字、千位分隔符、小数分隔符等的前缀、后缀和各种符号可设置为任意值，并且能在格式化期间正确显示。但是，必须注意不要让符号和字符串发生冲突，否则分析是不可靠的。例如，为了让 DecimalFormat.parse() 能够区分正数和负数，正数和负数前缀或后缀必须是不同的。（如果它们相同，则 DecimalFormat 的行为就如同未指定负数子模式一样。）另一个示例是小数分隔符和千位分隔符应该是不同的字符，否则将不可能进行分析。

分组分隔符通常用于千位，但是在某些国家中它用于分隔万位。分组大小是分组字符之间的固定数字位数，例如 100,000,000 是 3，而 1,0000,0000 则是 4。如果使用具有多个分组字符的模式，则最后一个分隔符和整数结尾之间的间隔才是使用的分组大小。所以 "#,##,###,####" == "######,####" == "##,####,####"。

特殊模式字符

模式中的很多字符都是按字面解释的；在分析期间对其进行匹配，在格式化期间则不经改变地输出。另一方面，特殊字符代表了其他字符、字符串或字符类。如果要将其作为字面量出现在前缀或后缀中，那么除非另行说明，否则必须对其加引号。

下列字符用在非本地化的模式中。已本地化的模式使用从此 formatter 的 DecimalFormatSymbols 对象中获得的相应字符，这些字符已失去其特殊状态。两种例外是货币符号和引号，不将其本地化。

符号	位置	本地化？	含义
0	数字	是	阿拉伯数字
#	数字字	是	阿拉伯数字，如果不存在则显示为 0
.	数字	是	小数分隔符或货币小数分隔符
-	数字	是	减号
,	数字	是	分组分隔符
E	数字	是	分隔科学计数法中的尾数和指数。在前缀或后缀中无需加引号。
;	子模式边界	是	分隔正数和负数子模式
%	前缀或后缀	是	乘以 100 并显示为百分数
\u2030	前缀或后缀	是	乘以 1000 并显示为千分数
¤ (\u00A4)	前缀或后缀	否	货币记号，由货币符号替换。如果两个同时出现，则用国际货币符号替换。如果出现在某个模式中，则使用货币小数分隔符，而不使用小数分隔符。
'	前缀或后缀	否	用于在前缀或或后缀中为特殊字符加引号，例如 "'#'#" 将 123 格式化为 "#123"。要创建单引号本身，请连续使用两个单引号："# o''clock"。

科学计数法

科学计数法中的数表示为一个尾数和一个 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"。要显示所有位数，请将有效位数计数设置为零。有效位数不会影响分析。
• 指数模式可能不包含分组分隔符。

舍入

DecimalFormat 使用 half-even 舍入（请参阅 ROUND_HALF_EVEN）进行格式化。

阿拉伯数字

为了进行格式化，DecimalFormat 使用 DecimalFormatSymbols 对象中所定义的、从已本地化的阿拉伯数字 0 开始的 10 个连续字符作为阿拉伯数字。为了进行分析，可识别 Character.digit 所定义的这些阿拉伯数字和所有 Unicode 十进制阿拉伯数字。

特殊值

NaN 被格式化为单个字符，通常是 \uFFFD。此字符由 DecimalFormatSymbols 对象所确定。这是惟一不使用前缀和后缀的值。

无穷大的值被格式化为单个字符，通常是 \u221E，具有正数或负数前缀和后缀。无穷大值的字符由 DecimalFormatSymbols 对象所确定。

将负零（"-0"）分析为

• 如果 isParseBigDecimal() 为 true，则为 BigDecimal(0)，
• 如果 isParseBigDecimal() 为 false 并且 isParseIntegerOnly() 为 true，则为 Long(0)，
• 如果 isParseBigDecimal() 和 isParseIntegerOnly() 均为 false，则为 Double(-0.0)。

同步

DecimalFormat 通常不是同步的。建议为每个线程创建独立的格式实例。如果多个线程同时访问某个格式，则必须保持外部同步。

示例

// 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) {}
     }
 }
=========================================分割线=========================================
 

例子：
import java.text.*; 
public class Untitled1     {
    public static void main(String[] args) {

      //---------------------------------------------
      //定义一个数字格式化对象，格式化模板为".##"，即保留2位小数.
      DecimalFormat a = new DecimalFormat(".##");
      String s= a.format(333.335);
      System.err.println(s);
      //说明：如果小数点后面不够2位小数，不会补零.参见Rounding小节
      //---------------------------------------------

      //-----------------------------------------------
      //可以在运行时刻用函数applyPattern(String)修改格式模板
      //保留2位小数，如果小数点后面不够2位小数会补零
      a.applyPattern(".00");
      s = a.format(333.3);
      System.err.println(s);
      //------------------------------------------------

      //------------------------------------------------
      //添加千分号
      a.applyPattern(".##\u2030");
      s = a.format(0.78934);
      System.err.println(s);//添加千位符后,小数会进三位并加上千位符
      //------------------------------------------------

      //------------------------------------------------
      //添加百分号
      a.applyPattern("#.##%");
      s = a.format(0.78645);
      System.err.println(s);
      //------------------------------------------------

     //------------------------------------------------
      //添加前、后修饰字符串，记得要用单引号括起来
      a.applyPattern("'这是我的钱$',###.###'美圆'");
      s = a.format(33333443.3333);
      System.err.println(s);
      //------------------------------------------------

       //------------------------------------------------
      //添加货币表示符号(不同的国家，添加的符号不一样
      a.applyPattern("\u00A4");
      s = a.format(34);
      System.err.println(s);
      //------------------------------------------------

      //-----------------------------------------------
      //定义正负数模板,记得要用分号隔开
       a.applyPattern("0.0;'@'-#.0");
       s = a.format(33);
       System.err.println(s);
       s = a.format(-33);
       System.err.println(s);
       //-----------------------------------------------
    
      //综合运用，正负数的不同前后缀
      String pattern="'my moneny'###,###.##'RMB';'ur money'###,###.##'US'";
      a.applyPattern(pattern);
      System.out.println(a.format(1223233.456));
    }
}

 总结：

要生成一个DecimalFormat对象，一般只要通过NumberFormat类工厂的getInstance()来取得一个NumberFormat对象再将其转换成DecimalFormat对象，然后通过DecimalForat对象的applyPattern()来动态改变数据的现示格式模板，通过format()方法取得格式化后的数字。同时,DecimalFormat提供了许多的方法来返回格式化后的数字的某一部份，这些方法如：getNegativeSuffix()。这个类的难点主要是在模板的书写及理解上。其实主要的就是针对一个数字的正负形式来设定不同的格式显示。这里要特别注意的是使用在模板上的特殊字符代表有特殊的意义，如下表所示： Symbol    Description 0    a digit #    a digit, zero shows as absent .    placeholder for decimal separator ,    placeholder for grouping separator E   separates mantissa and exponent for exponential formats ;    separates formats -    default negative prefix %    multiply by 100 and show as percentage ?    multiply by 1000 and show as per mille ¤    currency sign; replaced by currency symbol; if doubled, replaced by international currency symbol; if present in a pattern, the monetary decimal separator is used instead of the decimal separator   X    any other characters can be used in the prefix or suffix '    used to quote special characters in a prefix or suffix

例如：如果模板中含有#，意思是指这个#号可代表一个或多个数字如果该位的数字是零的话则省略该位。另：注意“#,##0.0#;(#)”这个模板的意思是指数字的负数形式跟正数的一样。