DecimalFormat (Java Platform SE 7)

java.lang.Object
- java.text.Format
- - java.text.NumberFormat
  - - java.text.DecimalFormat

すべての実装されたインタフェース:: Serializable、Cloneable

public class DecimalFormat
extends NumberFormat

DecimalFormat は NumberFormat の具象サブクラスであり、10 進数の書式を設定します。DecimalFormat には、西欧、アラビア、およびインド数字に対するサポートを含むさまざまな機能が用意されており、任意のロケールで数値の解析とフォーマットが実行できるよう設計されています。また、整数 (123)、固定小数値 (123.4)、科学表記法 (1.23E4)、パーセント (12%)、および通貨金額 ($123) などのさまざまな種類の数値もサポートしています。これらはすべてローカライズができます。

デフォルトのロケールなどの特定のロケールの NumberFormat を取得するためには、getInstance() などの NumberFormat のファクトリメソッドの 1 つを呼び出します。通常、NumberFormat ファクトリメソッドは DecimalFormat 以外のサブクラスを返す場合があるため、DecimalFormat コンストラクタを直接呼び出しません。フォーマットオブジェクトをカスタマイズする必要がある場合は、次のように実行します。

 NumberFormat f = NumberFormat.getInstance(loc);
 if (f instanceof DecimalFormat) {
     ((DecimalFormat) f).setDecimalSeparatorAlwaysShown(true);
 }

DecimalFormat はパターンおよび記号のセットで構成されます。パターンの設定は applyPattern() を使用して直接行うか、または API メソッドを使用して間接的に行います。記号は DecimalFormatSymbols オブジェクトに格納されます。NumberFormat ファクトリメソッドを使用している場合、パターンと記号はローカライズされた ResourceBundle から読み込まれます。

パターン

DecimalFormat の構文を次に示します。

 Pattern:
         PositivePattern
         PositivePattern ; NegativePattern
 PositivePattern:
         Prefix_opt Number Suffix_opt
 NegativePattern:
         Prefix_opt Number Suffix_opt
 Prefix:
         any Unicode characters except \uFFFE, \uFFFF, and special characters
 Suffix:
         any Unicode characters except \uFFFE, \uFFFF, and special characters
 Number:
         Integer Exponent_opt
         Integer . Fraction Exponent_opt
 Integer:
         MinimumInteger
         #
         # Integer
         # , Integer
 MinimumInteger:
         0
         0 MinimumInteger
         0 , MinimumInteger
 Fraction:
         MinimumFraction_opt OptionalFraction_opt
 MinimumFraction:
         0 MinimumFraction_opt
 OptionalFraction:
         # OptionalFraction_opt
 Exponent:
         E MinimumExponent
 MinimumExponent:
         0 MinimumExponent_opt

DecimalFormat パターンには "#,##0.00;(#,##0.00)" などの、正と負のサブパターンがあります。各サブパターンには接頭辞、数値部分、および接尾辞が 1 つずつあります。負のサブパターンはオプションです。このオプションを設定しない場合は、ローカライズされたマイナス記号 (ほとんどのロケールでは '-') を正のサブパターンに接頭辞として付けることで、負のサブパターンとして使用します。つまり、単独の "0.00" は "0.00;-0.00" と等価になります。明示的な負のサブパターンがあると、これは負の接頭辞と接尾辞を指定する場合にだけ機能します。桁数、最小桁数、およびその他の特性はすべて正のパターンと同じです。これは "#,##0.0#;(#)" は "#,##0.0#;(#,##0.0#)" と正確に同じ結果になることを意味します。

接頭辞、接尾辞、および無限大、桁、1000 の区切り、および小数の区切り文字などに使用するさまざまな記号は、任意の値に設定でき、フォーマット中に正しく表示されます。ただし、記号と文字列が矛盾しないように注意をしないと、解析は信頼性を持ちません。たとえば、DecimalFormat.parse() で正の値と負の値を区別できるように、正と負の接頭辞や接尾辞は異なる必要があります。同一であると、DecimalFormat は負のサブパターンが指定されていないものとして動作します。別の例として、数値桁区切り子と 1000 の区切り子には異なる文字を使用する必要があります。同一の文字を使用すると解析が不可能になります。

グループ区切り子は一般に 1000 ごとに区切るために使用しますが、国によっては 10000 ごとに使用するところもあります。グループ区切りのサイズとは、100,000,000 の場合は 3、1,0000,0000 の場合は 4 というように、グループ区切り文字間の一定の桁数です。複数のグループ区切り文字を持つパターンを指定すると、最後の区切り文字と末尾の整数との間が、この間隔として使用されます。したがって、"#,##,###,####" == "######,####" == "##,####,####" となります。

特殊パターン文字

パターン内の多くの文字は文字どおりに取得されます。このような文字は解析中に一致すると、フォーマット中にそのまま出力されます。一方、特殊文字はほかの文字、文字列、または文字のクラスを表します。特殊文字は、接頭辞や接尾辞にリテラルとして表示する場合は、特に指示がないかぎり、引用符で囲む必要があります。

次にリストする文字は、ローカライズされていないパターンで使用されます。ローカライズされていないパターンでは、代わりにこのフォーマッタの DecimalFormatSymbols オブジェクトから取得した対応する文字を使用すると、これらの文字は特殊な状態ではなくなります。2 つの例外はローカライズされていない通貨記号と引用符です。

記号位置ローカライズの有無意味
0 Number あり数字
# Number あり数字。ゼロだと表示されない
. Number あり数値桁区切り子または通貨桁区切り子
- Number ありマイナス記号
, Number ありグループ区切り子
E Number あり科学表記法の仮数と指数を区切る。接頭辞や接尾辞内に引用符を付ける必要はない。
; サブパターン境界あり正と負のサブパターンを区切る
% 接頭辞または接尾辞あり 100 倍してパーセントを表す
\u2030 接頭辞または接尾辞あり 1000 倍してパーミル値を表す
¤ (\u00A4) 接頭辞または接尾辞なし通貨記号で置換される通貨符号。2 つの場合は、国際通貨記号で置換される。パターン内にある場合は、数値桁区切り子ではなく、通貨桁区切り子が使用される。
' 接頭辞または接尾辞なし接頭辞や接尾辞内の特殊文字を引用符で囲む場合に使用される。たとえば、"'#'#" を使用すると 123 は "#123" にフォーマットされる。単一引用符自体を作成するには、1 行に 2 つ引用符を使用する ("# o''clock")。

記号	位置	ローカライズの有無	意味
`0`	Number	あり	数字
`#`	Number	あり	数字。ゼロだと表示されない
`.`	Number	あり	数値桁区切り子または通貨桁区切り子
`-`	Number	あり	マイナス記号
`,`	Number	あり	グループ区切り子
`E`	Number	あり	科学表記法の仮数と指数を区切る。接頭辞や接尾辞内に引用符を付ける必要はない。
`;`	サブパターン境界	あり	正と負のサブパターンを区切る
`%`	接頭辞または接尾辞	あり	100 倍してパーセントを表す
`\u2030`	接頭辞または接尾辞	あり	1000 倍してパーミル値を表す
`¤` (`\u00A4`)	接頭辞または接尾辞	なし	通貨記号で置換される通貨符号。2 つの場合は、国際通貨記号で置換される。パターン内にある場合は、数値桁区切り子ではなく、通貨桁区切り子が使用される。
`'`	接頭辞または接尾辞	なし	接頭辞や接尾辞内の特殊文字を引用符で囲む場合に使用される。たとえば、`"'#'#"` を使用すると 123 は `"#123"` にフォーマットされる。単一引用符自体を作成するには、1 行に 2 つ引用符を使用する (`"# o''clock"`)。

科学表記法

科学表記法の数値は仮数と 10 の累乗の結果として表されます。たとえば、1234 は 1.234 x 10^3 として表されます。仮数の多くは 1.0 <= x <10.0 の範囲内ですが、必ずしもこの範囲内にする必要はありません。DecimalFormat には、パターンだけを介して科学表記法をフォーマットおよび解析するよう指示できます。現在、科学表記法形式を作成するファクトリメソッドはありません。パターンでは、指数文字の直後に 1 つ以上の数字を続けて科学表記法を示します。例:"0.###E0" では、1234 は "1.234E3" のようにフォーマットされます。

指数文字の後ろの数字の個数は、指数の最小桁数を示します。最大桁数はありません。負の指数は、パターンによる接頭辞や接尾辞ではなく、ローカライズされたマイナス記号を使用してフォーマットされます。これによって、"0.###E0 m/s" などのパターンが許可されます。
整数の最小桁数と最大桁数は同時に解釈されます。
- 整数の最大桁数がその最小桁数より大きく、1 より大きい場合、指数は整数の最大桁数の倍数になり、整数の最小桁数は 1 として解釈されます。これは、技術表記法の場合によく使用されます。この場合、指数は "##0.#####E0" などのように 3 の倍数になります。このパターンを使用すると、数値 12345 は "12.345E3" に、123456 は "123.456E3" にフォーマットされます。
- そうでない場合、整数の最小桁数は指数を調整することによって得られます。例:0.00123 は "00.###E0" を使用して "12.3E-4" とフォーマットされます。
仮数の有効桁数は、最小整数と最大小数の桁数の合計です。有効桁数は整数の最大桁数に影響を受けません。たとえば、12345 は "##0.##E0" を使用して "12.3E3" とフォーマットされます。すべての桁を表示する場合は、有効桁数をゼロに設定してください。有効桁数は解析に影響しません。
指数パターンにはグループ区切り子が含まれない場合があります。

丸め

DecimalFormat は、RoundingMode で定義されている丸めモードをフォーマット処理に提供します。デフォルトでは、RoundingMode.HALF_EVEN が使用されます。

Digits

DecimalFormat は、フォーマットに DecimalFormatSymbols オブジェクトで定義されている、ローカライズされたゼロ数字で始まる 10 個の連続した文字を数字として使用します。解析では、これらの数字とともに、Character.digit の定義によるすべての Unicode 10 進数を認識します。

特殊な値

NaN は、通常は単一の文字 \uFFFD を持つ文字列としてフォーマットされます。この文字列は DecimalFormatSymbols オブジェクトによって判定されます。これは、接頭辞と接尾辞が使用されない唯一の値です。

無限大は、通常は単一の文字 \u221E を持つ文字列としてフォーマットされ、負または正の接頭辞および接尾辞が適用されます。無限大文字列は DecimalFormatSymbols オブジェクトによって判定されます。

負のゼロ ("-0") は、

isParseBigDecimal() が true である場合は BigDecimal(0) と解析され、
isParseBigDecimal() が false、isParseIntegerOnly() が true である場合はLong(0) と解析され、
isParseBigDecimal() と isParseIntegerOnly() がどちらも false である場合は Double(-0.0) と解析されます。

同期

decimal フォーマットは同期化されません。スレッドごとに別のフォーマットインスタンスを作成することをお勧めします。複数のスレッドがフォーマットに並行してアクセスする場合は、外部的に同期化する必要があります。

例

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

関連項目:: Java Tutorial, NumberFormat, DecimalFormatSymbols, ParsePosition, 直列化された形式

ネストされたクラスのサマリー
- クラス java.text.NumberFormat から継承されたネストされたクラス/インタフェース
  NumberFormat.Field

フィールドのサマリー
- クラス java.text.NumberFormat から継承されたフィールド
  FRACTION_FIELD, INTEGER_FIELD

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`DecimalFormat()` デフォルトロケールに対して、デフォルトのパターンと記号を使って DecimalFormat を作成します。
`DecimalFormat(String pattern)` デフォルトロケールに対して、指定されたパターンと記号を使って DecimalFormat を作成します。
`DecimalFormat(String pattern, DecimalFormatSymbols symbols)` 指定されたパターンと記号を使って DecimalFormat を作成します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`void`	`applyLocalizedPattern(String pattern)` 指定されたパターンをこの Format オブジェクトに適用します。
`void`	`applyPattern(String pattern)` 指定されたパターンをこの Format オブジェクトに適用します。
`Object`	`clone()` 標準オーバーライドです。セマンティクスは変わりません。
`boolean`	`equals(Object obj)` equals をオーバーライドします。
`StringBuffer`	`format(double number, StringBuffer result, FieldPosition fieldPosition)` double をフォーマットして文字列を作成します。
`StringBuffer`	`format(long number, StringBuffer result, FieldPosition fieldPosition)` long をフォーマットして文字列を作成します。
`StringBuffer`	`format(Object number, StringBuffer toAppendTo, FieldPosition pos)` 数値をフォーマットし、その結果のテキストを指定された文字列バッファーに追加します。
`AttributedCharacterIterator`	`formatToCharacterIterator(Object obj)` Object をフォーマットし、`AttributedCharacterIterator` を生成します。
`Currency`	`getCurrency()` 通貨値のフォーマット時に、この 10 進フォーマットが使用する通貨を取得します。
`DecimalFormatSymbols`	`getDecimalFormatSymbols()` 数値桁区切り文字のコピーを返します。これは通常、プログラマやユーザーによって変更されません。
`int`	`getGroupingSize()` グループ化サイズを返します。
`int`	`getMaximumFractionDigits()` 数値の小数部分の最大桁数を取得します。
`int`	`getMaximumIntegerDigits()` 数値の整数部分の最大桁数を取得します。
`int`	`getMinimumFractionDigits()` 数値の小数部分の最小桁数を取得します。
`int`	`getMinimumIntegerDigits()` 数値の整数部分の最小桁数を取得します。
`int`	`getMultiplier()` パーセント、パーミル (1000)、およびその類似フォーマットで使用する乗数を取得します。
`String`	`getNegativePrefix()` 負の接頭辞を取得します。
`String`	`getNegativeSuffix()` 負の接尾辞を取得します。
`String`	`getPositivePrefix()` 正の接頭辞を取得します。
`String`	`getPositiveSuffix()` 正の接尾辞を取得します。
`RoundingMode`	`getRoundingMode()` この DecimalFormat で使用される `RoundingMode` を取得します。
`int`	`hashCode()` hashCode をオーバーライドします。
`boolean`	`isDecimalSeparatorAlwaysShown()` 整数と区別する小数点の動作を取得します。
`boolean`	`isParseBigDecimal()` `parse(java.lang.String, java.text.ParsePosition)` メソッドが `BigDecimal` を返すかどうかを返します。
`Number`	`parse(String text, ParsePosition pos)` 文字列からテキストを解析して `Number` を生成します。
`void`	`setCurrency(Currency currency)` 通貨値のフォーマット時に、この数値フォーマットが使用する通貨を設定します。
`void`	`setDecimalFormatSymbols(DecimalFormatSymbols newSymbols)` 数値桁区切り文字を設定します。これは通常、プログラマやユーザーによって変更されません。
`void`	`setDecimalSeparatorAlwaysShown(boolean newValue)` 整数と区別する小数点の動作を設定します。
`void`	`setGroupingSize(int newValue)` グループ化サイズを設定します。
`void`	`setMaximumFractionDigits(int newValue)` 数値の小数部分の最大桁数を設定します。
`void`	`setMaximumIntegerDigits(int newValue)` 数値の整数部分の最大桁数を設定します。
`void`	`setMinimumFractionDigits(int newValue)` 数値の小数部分の最小桁数を設定します。
`void`	`setMinimumIntegerDigits(int newValue)` 数値の整数部分の最小桁数を設定します。
`void`	`setMultiplier(int newValue)` パーセント、パーミル (1000)、およびその類似フォーマットで使用する乗数を設定します。
`void`	`setNegativePrefix(String newValue)` 負の接頭辞を設定します。
`void`	`setNegativeSuffix(String newValue)` 負の接尾辞を設定します。
`void`	`setParseBigDecimal(boolean newValue)` `parse(java.lang.String, java.text.ParsePosition)` メソッドが `BigDecimal` を返すかどうかを設定します。
`void`	`setPositivePrefix(String newValue)` 正の接頭辞を設定します。
`void`	`setPositiveSuffix(String newValue)` 正の接尾辞を設定します。
`void`	`setRoundingMode(RoundingMode roundingMode)` この DecimalFormat で使用される `RoundingMode` を設定します。
`String`	`toLocalizedPattern()` この Format オブジェクトの現在の状態を表すローカライズされたパターン文字列を総合します。
`String`	`toPattern()` この Format オブジェクトの現在の状態を表すパターン文字列を総合します。

クラス java.text.NumberFormat から継承されたメソッド
format, format, getAvailableLocales, getCurrencyInstance, getCurrencyInstance, getInstance, getInstance, getIntegerInstance, getIntegerInstance, getNumberInstance, getNumberInstance, getPercentInstance, getPercentInstance, isGroupingUsed, isParseIntegerOnly, parse, parseObject, setGroupingUsed, setParseIntegerOnly

クラス java.text.Format から継承されたメソッド
format, parseObject

クラス java.lang.Object から継承されたメソッド
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - DecimalFormat
```
public DecimalFormat()
```
    デフォルトロケールに対して、デフォルトのパターンと記号を使って DecimalFormat を作成します。これは、国際化が主要な問題でない場合は、DecimalFormat を得るためには簡単な方法です。
    指定されたロケールに対する標準フォーマットを得るには、getNumberInstance など、NumberFormat のファクトリメソッドを使用してください。これらのファクトリメソッドは、指定されたロケールに対する NumberFormat の最適なサブクラスを返します。
    
    関連項目:
    NumberFormat.getInstance(), NumberFormat.getNumberInstance(), NumberFormat.getCurrencyInstance(), NumberFormat.getPercentInstance()
  - DecimalFormat
```
public DecimalFormat(String pattern)
```
    デフォルトロケールに対して、指定されたパターンと記号を使って DecimalFormat を作成します。これは、国際化が主要な問題でない場合は、DecimalFormat を得るためには簡単な方法です。
    指定されたロケールに対する標準フォーマットを得るには、getNumberInstance など、NumberFormat のファクトリメソッドを使用してください。これらのファクトリメソッドは、指定されたロケールに対する NumberFormat の最適なサブクラスを返します。
    
    パラメータ:
    pattern - ローカライズされていないパターン文字列。
    
    例外:
    
    NullPointerException - pattern が null である場合
    
    IllegalArgumentException - 指定されたパターンが無効な場合。
    関連項目:
    NumberFormat.getInstance(), NumberFormat.getNumberInstance(), NumberFormat.getCurrencyInstance(), NumberFormat.getPercentInstance()
  - DecimalFormat
```
public DecimalFormat(String pattern,
             DecimalFormatSymbols symbols)
```
    指定されたパターンと記号を使って DecimalFormat を作成します。フォーマットの動作を完全にカスタマイズする必要がある場合には、このコンストラクタを使ってください。
    指定されたロケールに対する標準フォーマットを得るには、getInstance や getCurrencyInstance など、NumberFormat のファクトリメソッドを使用してください。標準フォーマットをわずかに調整するだけであれば、NumberFormat ファクトリメソッドで返されたフォーマットを修正することができます。
    
    パラメータ:
    pattern - ローカライズされていないパターン文字列
    symbols - 使用する記号セット
    
    例外:
    
    NullPointerException - 指定された引数が 1 つでも null の場合
    
    IllegalArgumentException - 指定されたパターンが無効な場合
    関連項目:
    NumberFormat.getInstance(), NumberFormat.getNumberInstance(), NumberFormat.getCurrencyInstance(), NumberFormat.getPercentInstance(), DecimalFormatSymbols
- メソッドの詳細
  - format
```
public final StringBuffer format(Object number,
                  StringBuffer toAppendTo,
                  FieldPosition pos)
```
    数値をフォーマットし、その結果のテキストを指定された文字列バッファーに追加します。指定可能な数値は、Number の任意のサブクラスです。
    この実装は最大許容精度を使用します。
    
    オーバーライド:
    
    format、クラス: NumberFormat
    
    パラメータ:
    number - フォーマットする数値
    toAppendTo - フォーマット後のテキストを追加する StringBuffer
    pos - 入力では、必要であれば位置合わせフィールド。出力では、その位置合わせフィールドのオフセット。
    
    戻り値:
    toAppendTo として渡された値
    
    例外:
    
    IllegalArgumentException - number が null であるか、Number のインスタンスでない場合。
    
    NullPointerException - toAppendTo または pos が null の場合
    
    ArithmeticException - 丸め処理が必要な場合に丸めモードが RoundingMode.UNNECESSARY に設定されているとき
    関連項目:
    FieldPosition
  - format
```
public StringBuffer format(double number,
                  StringBuffer result,
                  FieldPosition fieldPosition)
```
    double をフォーマットして文字列を作成します。
    
    定義:
    
    format、クラス: NumberFormat
    
    パラメータ:
    number - フォーマットする double
    result - テキストを追加する位置
    fieldPosition - 入力では、必要であれば位置合わせフィールド。出力では、その位置合わせフィールドのオフセット。
    
    戻り値:
    フォーマットされた数値文字列
    
    例外:
    
    ArithmeticException - 丸め処理が必要な場合に丸めモードが RoundingMode.UNNECESSARY に設定されているとき
    関連項目:
    FieldPosition
  - format
```
public StringBuffer format(long number,
                  StringBuffer result,
                  FieldPosition fieldPosition)
```
    long をフォーマットして文字列を作成します。
    
    定義:
    
    format、クラス: NumberFormat
    
    パラメータ:
    number - フォーマットする long
    result - テキストを追加する位置
    fieldPosition - 入力では、必要であれば位置合わせフィールド。出力では、その位置合わせフィールドのオフセット。
    
    戻り値:
    フォーマットされた数値文字列
    
    例外:
    
    ArithmeticException - 丸め処理が必要な場合に丸めモードが RoundingMode.UNNECESSARY に設定されているとき
    関連項目:
    FieldPosition
  - formatToCharacterIterator
```
public AttributedCharacterIterator formatToCharacterIterator(Object obj)
```
    Object をフォーマットし、AttributedCharacterIterator を生成します。返された AttributedCharacterIterator を使用すると、結果の String を構築できるとともに、結果の String についての情報を判定できます。
    AttributedCharacterIterator の各属性キーは NumberFormat.Field 型です。属性値は属性キーと同一です。
    
    オーバーライド:
    
    formatToCharacterIterator、クラス: Format
    
    パラメータ:
    obj - フォーマットするオブジェクト
    
    戻り値:
    フォーマットされた値を説明する AttributedCharacterIterator。
    
    例外:
    
    NullPointerException - obj が null の場合。
    
    IllegalArgumentException - 指定されたオブジェクトを Format でフォーマットできない場合。
    
    ArithmeticException - 丸め処理が必要な場合に丸めモードが RoundingMode.UNNECESSARY に設定されているとき
    導入されたバージョン:
    
    1.4
  - parse
```
public Number parse(String text,
           ParsePosition pos)
```
    文字列からテキストを解析して Number を生成します。
    メソッドは pos によって指定されたインデックスを開始位置としてテキストの解析を試みます。解析が完了すると、pos のインデックスは、使用された最後の文字 (解析では、文字列の最後までのすべての文字が使用されるとは限らない) のあとのインデックスに更新され、解析された数値が返されます。更新された pos は、このメソッドの次の呼び出しの開始点を示すのに使用できます。エラーが発生した場合は、pos のインデックスは変更されず、エラーが発生した文字のインデックスに pos のエラーインデックスが設定され、null が返されます。
    戻り値のサブクラスは、isParseBigDecimal() の値と解析対象文字列によって決まります。
    - isParseBigDecimal() が false (デフォルト値) の場合、整数値の大部分は、その記述形式にかかわらず、Long オブジェクトとして返されます。"17" と "17.000" はどちらも、Long(17) として解析されます。Long に当てはまらない値は Double として返されます。これには小数部分を持つ値、無限大の値、NaN、および値 -0.0 などが含まれます。DecimalFormat は、Double、Long のいずれを返すかを、ソース文字列内での小数区切り文字の有無で判断するわけではありません。かりにそうした場合は、"-9,223,372,036,854,775,808.00" などの double の仮数をオーバーフローする整数を、正確に解析できなくなります。
      呼び出し元は、Number のメソッド doubleValue や longValue を用いることで、値を必要な型として取得できます。
    - isParseBigDecimal() が true の場合、値は BigDecimal オブジェクトとして返されます。この値は、ロケール非依存形式の対応する文字列に対して、BigDecimal.BigDecimal(String) によって構築される値です。ただし、特殊な値 (正負の無限大や NaN など) は、対応する Double 定数値を含む Double インスタンスとして返されます。
    DecimalFormat は、Character.digit() で定義されている 10 進数字を表すすべての Unicode 文字を解析します。さらに DecimalFormat は、DecimalFormatSymbols オブジェクトで定義されているローカライズされたゼロ数字で始まる 10 個の連続した文字を数字として認識します。
    定義:
    
    parse、クラス: NumberFormat
    
    パラメータ:
    text - 解析される文字列
    pos - 上記のインデックスおよびエラーインデックス情報を持つ ParsePosition オブジェクト
    
    戻り値:
    解析された値。解析が失敗した場合は null
    
    例外:
    
    NullPointerException - text または pos が null の場合。
    関連項目:
    NumberFormat.isParseIntegerOnly(), Format.parseObject(java.lang.String, java.text.ParsePosition)
  - getDecimalFormatSymbols
```
public DecimalFormatSymbols getDecimalFormatSymbols()
```
    数値桁区切り文字のコピーを返します。これは通常、プログラマやユーザーによって変更されません。
    
    戻り値:
    必要な DecimalFormatSymbols のコピー
    関連項目:
    DecimalFormatSymbols
  - setDecimalFormatSymbols
```
public void setDecimalFormatSymbols(DecimalFormatSymbols newSymbols)
```
    数値桁区切り文字を設定します。これは通常、プログラマやユーザーによって変更されません。
    
    パラメータ:
    newSymbols - 必要な DecimalFormatSymbols
    関連項目:
    DecimalFormatSymbols
  - getPositivePrefix
```
public String getPositivePrefix()
```
    正の接頭辞を取得します。
    例+123、$123、sFr123
  - setPositivePrefix
```
public void setPositivePrefix(String newValue)
```
    正の接頭辞を設定します。
    例+123、$123、sFr123
  - getNegativePrefix
```
public String getNegativePrefix()
```
    負の接頭辞を取得します。
    例-123、($123) (負の接尾辞付き)、sFr-123
  - setNegativePrefix
```
public void setNegativePrefix(String newValue)
```
    負の接頭辞を設定します。
    例-123、($123) (負の接尾辞付き)、sFr-123
  - getPositiveSuffix
```
public String getPositiveSuffix()
```
    正の接尾辞を取得します。
    例: 123%
  - setPositiveSuffix
```
public void setPositiveSuffix(String newValue)
```
    正の接尾辞を設定します。
    例: 123%
  - getNegativeSuffix
```
public String getNegativeSuffix()
```
    負の接尾辞を取得します。
    例-123%、($123) (正の接尾辞付き)
  - setNegativeSuffix
```
public void setNegativeSuffix(String newValue)
```
    負の接尾辞を設定します。
    例 123%
  - getMultiplier
```
public int getMultiplier()
```
    パーセント、パーミル (1000)、およびその類似フォーマットで使用する乗数を取得します。
    
    関連項目:
    setMultiplier(int)
  - setMultiplier
```
public void setMultiplier(int newValue)
```
    パーセント、パーミル (1000)、およびその類似フォーマットで使用する乗数を設定します。パーセントでは、乗数として 100 を、接尾辞として % を設定します (アラビア語では異なるパーセント記号を使用する)。パーミルでは、乗数として 1000 を、接尾辞として '\u2030' を設定します。
    例:乗数 100 の場合、1.23 のフォーマット結果は "123"、"123" の解析結果は 1.23 になる。
    
    関連項目:
    getMultiplier()
  - getGroupingSize
```
public int getGroupingSize()
```
    グループ化サイズを返します。グループ化サイズとは、数値の整数部分における区切り文字と区切り文字の間の桁数です。たとえば、数値 123,456.78 の場合、グループ化サイズは 3 です。
    
    関連項目:
    setGroupingSize(int), NumberFormat.isGroupingUsed(), DecimalFormatSymbols.getGroupingSeparator()
  - setGroupingSize
```
public void setGroupingSize(int newValue)
```
    グループ化サイズを設定します。グループ化サイズとは、数値の整数部分における区切り文字と区切り文字の間の桁数です。たとえば、数値 123,456.78 の場合、グループ化サイズは 3 です。
    引数として渡された値はバイトに変換されるため、情報が失われる可能性があります。
    
    関連項目:
    getGroupingSize(), NumberFormat.setGroupingUsed(boolean), DecimalFormatSymbols.setGroupingSeparator(char)
  - isDecimalSeparatorAlwaysShown
```
public boolean isDecimalSeparatorAlwaysShown()
```
    整数と区別する小数点の動作を取得します。(小数位では小数点が常に表示される)。
    例: Decimal ON: 12345 -> 12345.、OFF: 12345 -> 12345
  - setDecimalSeparatorAlwaysShown
```
public void setDecimalSeparatorAlwaysShown(boolean newValue)
```
    整数と区別する小数点の動作を設定します。(小数位では小数点が常に表示される)。
    例: Decimal ON: 12345 -> 12345.、OFF: 12345 -> 12345
  - isParseBigDecimal
```
public boolean isParseBigDecimal()
```
    parse(java.lang.String, java.text.ParsePosition) メソッドが BigDecimal を返すかどうかを返します。デフォルト値は false です。
    
    導入されたバージョン:
    
    1.5
    
    関連項目:
    setParseBigDecimal(boolean)
  - setParseBigDecimal
```
public void setParseBigDecimal(boolean newValue)
```
    parse(java.lang.String, java.text.ParsePosition) メソッドが BigDecimal を返すかどうかを設定します。
    
    導入されたバージョン:
    
    1.5
    
    関連項目:
    isParseBigDecimal()
  - clone
```
public Object clone()
```
    標準オーバーライドです。セマンティクスは変わりません。
    
    オーバーライド:
    
    clone、クラス: NumberFormat
    
    戻り値:
    このインスタンスの複製。
    関連項目:
    Cloneable
  - equals
```
public boolean equals(Object obj)
```
    equals をオーバーライドします。
    
    オーバーライド:
    
    equals、クラス: NumberFormat
    
    パラメータ:
    obj - 比較対象の参照オブジェクト。
    
    戻り値:
    このオブジェクトが obj 引数と同じである場合は true、それ以外の場合は false。
    関連項目:
    Object.hashCode()、HashMap
  - hashCode
```
public int hashCode()
```
    hashCode をオーバーライドします。
    
    オーバーライド:
    
    hashCode、クラス: NumberFormat
    
    戻り値:
    このオブジェクトのハッシュコード値。
    関連項目:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toPattern
```
public String toPattern()
```
    この Format オブジェクトの現在の状態を表すパターン文字列を総合します。
    
    関連項目:
    applyPattern(java.lang.String)
  - toLocalizedPattern
```
public String toLocalizedPattern()
```
    この Format オブジェクトの現在の状態を表すローカライズされたパターン文字列を総合します。
    
    関連項目:
    applyPattern(java.lang.String)
  - applyPattern
```
public void applyPattern(String pattern)
```
    指定されたパターンをこの Format オブジェクトに適用します。パターンとは、各種のフォーマット特性に対する簡略仕様です。これらの特性は、各設定機能メソッドで個別に変更することもできます。
    このルーチンで設定される整数の桁数に制限はありません。これは、一般なエンドユーザーの要望であるためです。実際の値を設定したい場合は、setMaximumInteger を使用してください。負の数値の場合は、セミコロンで区切った 2 つめのパターンを使用します。
    例 "#,#00.0#" -> 1,234.56
    これは、最小 2 桁の整数、1 つの小数点、最大 2 桁の小数を意味します。
    例: "#,#00.0#;(#,#00.0#)" (負の数値は括弧で囲む)。
    負のパターンでは、最小と最大の桁数は無視されます。これらは、正のパターンで設定されるものと見なされます。
    
    例外:
    
    NullPointerException - pattern が null である場合
    
    IllegalArgumentException - 指定されたパターンが無効な場合。
  - applyLocalizedPattern
```
public void applyLocalizedPattern(String pattern)
```
    指定されたパターンをこの Format オブジェクトに適用します。このパターンの表記は、ローカライズされているものと見なされます。パターンとは、各種のフォーマット特性に対する簡略仕様です。これらの特性は、各設定機能メソッドで個別に変更することもできます。
    このルーチンで設定される整数の桁数に制限はありません。これは、一般なエンドユーザーの要望であるためです。実際の値を設定したい場合は、setMaximumInteger を使用してください。負の数値の場合は、セミコロンで区切った 2 つめのパターンを使用します。
    例 "#,#00.0#" -> 1,234.56
    これは、最小 2 桁の整数、1 つの小数点、最大 2 桁の小数を意味します。
    例: "#,#00.0#;(#,#00.0#)" (負の数値は括弧で囲む)。
    負のパターンでは、最小と最大の桁数は無視されます。これらは、正のパターンで設定されるものと見なされます。
    
    例外:
    
    NullPointerException - pattern が null である場合
    
    IllegalArgumentException - 指定されたパターンが無効な場合。
  - setMaximumIntegerDigits
```
public void setMaximumIntegerDigits(int newValue)
```
    数値の整数部分の最大桁数を設定します。BigInteger オブジェクトおよび BigDecimal オブジェクト以外の数値をフォーマットする場合、newValue と 309 のうちの小さいほうが使用されます。負の入力値は 0 に置き換えられます。
    
    オーバーライド:
    
    setMaximumIntegerDigits、クラス: NumberFormat
    
    パラメータ:
    newValue - 整数の最大表示桁数。0 より小さい場合は 0 が使用される。具象サブクラスでは、この値の上限を、フォーマットされる数値の種類に適した値に強制できる。
    関連項目:
    NumberFormat.setMaximumIntegerDigits(int)
  - setMinimumIntegerDigits
```
public void setMinimumIntegerDigits(int newValue)
```
    数値の整数部分の最小桁数を設定します。BigInteger オブジェクトおよび BigDecimal オブジェクト以外の数値をフォーマットする場合、newValue と 309 のうちの小さいほうが使用されます。負の入力値は 0 に置き換えられます。
    
    オーバーライド:
    
    setMinimumIntegerDigits、クラス: NumberFormat
    
    パラメータ:
    newValue - 整数の最小表示桁数。0 より小さい場合は 0 が使用される。具象サブクラスでは、この値の上限を、フォーマットされる数値の種類に適した値に強制できる。
    関連項目:
    NumberFormat.setMinimumIntegerDigits(int)
  - setMaximumFractionDigits
```
public void setMaximumFractionDigits(int newValue)
```
    数値の小数部分の最大桁数を設定します。BigInteger オブジェクトおよび BigDecimal オブジェクト以外の数値をフォーマットする場合、newValue と 340 のうちの小さいほうが使用されます。負の入力値は 0 に置き換えられます。
    
    オーバーライド:
    
    setMaximumFractionDigits、クラス: NumberFormat
    
    パラメータ:
    newValue - 小数部の最大表示桁数。0 より小さい場合は 0 が使用される。具象サブクラスでは、この値の上限を、フォーマットされる数値の種類に適した値に強制できる。
    関連項目:
    NumberFormat.setMaximumFractionDigits(int)
  - setMinimumFractionDigits
```
public void setMinimumFractionDigits(int newValue)
```
    数値の小数部分の最小桁数を設定します。BigInteger オブジェクトおよび BigDecimal オブジェクト以外の数値をフォーマットする場合、newValue と 340 のうちの小さいほうが使用されます。負の入力値は 0 に置き換えられます。
    
    オーバーライド:
    
    setMinimumFractionDigits、クラス: NumberFormat
    
    パラメータ:
    newValue - 小数部の最小表示桁数。0 より小さい場合は 0 が使用される。具象サブクラスでは、この値の上限を、フォーマットされる数値の種類に適した値に強制できる。
    関連項目:
    NumberFormat.setMinimumFractionDigits(int)
  - getMaximumIntegerDigits
```
public int getMaximumIntegerDigits()
```
    数値の整数部分の最大桁数を取得します。BigInteger オブジェクトおよび BigDecimal オブジェクト以外の数値をフォーマットする場合、この戻り値と 309 のうちの小さいほうが使用されます。
    
    オーバーライド:
    
    getMaximumIntegerDigits、クラス: NumberFormat
    
    関連項目:
    setMaximumIntegerDigits(int)
  - getMinimumIntegerDigits
```
public int getMinimumIntegerDigits()
```
    数値の整数部分の最小桁数を取得します。BigInteger オブジェクトおよび BigDecimal オブジェクト以外の数値をフォーマットする場合、この戻り値と 309 のうちの小さいほうが使用されます。
    
    オーバーライド:
    
    getMinimumIntegerDigits、クラス: NumberFormat
    
    関連項目:
    setMinimumIntegerDigits(int)
  - getMaximumFractionDigits
```
public int getMaximumFractionDigits()
```
    数値の小数部分の最大桁数を取得します。BigInteger オブジェクトおよび BigDecimal オブジェクト以外の数値をフォーマットする場合、この戻り値と 340 のうちの小さいほうが使用されます。
    
    オーバーライド:
    
    getMaximumFractionDigits、クラス: NumberFormat
    
    関連項目:
    setMaximumFractionDigits(int)
  - getMinimumFractionDigits
```
public int getMinimumFractionDigits()
```
    数値の小数部分の最小桁数を取得します。BigInteger オブジェクトおよび BigDecimal オブジェクト以外の数値をフォーマットする場合、この戻り値と 340 のうちの小さいほうが使用されます。
    
    オーバーライド:
    
    getMinimumFractionDigits、クラス: NumberFormat
    
    関連項目:
    setMinimumFractionDigits(int)
  - getCurrency
```
public Currency getCurrency()
```
    通貨値のフォーマット時に、この 10 進フォーマットが使用する通貨を取得します。この通貨は、この数値フォーマットの記号に対して DecimalFormatSymbols.getCurrency を呼び出すことで取得されます。
    
    オーバーライド:
    
    getCurrency、クラス: NumberFormat
    
    戻り値:
    この 10 進フォーマットで使用される通貨、または null
    導入されたバージョン:
    
    1.4
  - setCurrency
```
public void setCurrency(Currency currency)
```
    通貨値のフォーマット時に、この数値フォーマットが使用する通貨を設定します。これは、数値フォーマットが使用する最小小数桁数または最大小数桁数を更新するものではありません。この通貨は、この数値フォーマットの記号に対して DecimalFormatSymbols.setCurrency を呼び出すことで設定されます。
    
    オーバーライド:
    
    setCurrency、クラス: NumberFormat
    
    パラメータ:
    currency - この 10 進フォーマットで使用する新しい通貨
    
    例外:
    
    NullPointerException - currency が null である場合
    導入されたバージョン:
    
    1.4
  - getRoundingMode
```
public RoundingMode getRoundingMode()
```
    この DecimalFormat で使用される RoundingMode を取得します。
    
    オーバーライド:
    
    getRoundingMode、クラス: NumberFormat
    
    戻り値:
    この DecimalFormat に使用される RoundingMode。
    導入されたバージョン:
    
    1.6
    
    関連項目:
    setRoundingMode(RoundingMode)
  - setRoundingMode
```
public void setRoundingMode(RoundingMode roundingMode)
```
    この DecimalFormat で使用される RoundingMode を設定します。
    
    オーバーライド:
    
    setRoundingMode、クラス: NumberFormat
    
    パラメータ:
    roundingMode - 使用される RoundingMode
    
    例外:
    
    NullPointerException - roundingMode が null である場合。
    導入されたバージョン:
    
    1.6
    
    関連項目:
    getRoundingMode()

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス DecimalFormat

パターン

特殊パターン文字

科学表記法

丸め

Digits

特殊な値

同期

例

ネストされたクラスのサマリー

クラス java.text.NumberFormat から継承されたネストされたクラス/インタフェース

フィールドのサマリー

クラス java.text.NumberFormat から継承されたフィールド

コンストラクタのサマリー

メソッドのサマリー

クラス java.text.NumberFormat から継承されたメソッド

クラス java.text.Format から継承されたメソッド

クラス java.lang.Object から継承されたメソッド

コンストラクタの詳細

DecimalFormat

DecimalFormat

DecimalFormat

メソッドの詳細

format

format

format

formatToCharacterIterator

parse

getDecimalFormatSymbols

setDecimalFormatSymbols

getPositivePrefix

setPositivePrefix

getNegativePrefix

setNegativePrefix

getPositiveSuffix

setPositiveSuffix

getNegativeSuffix

setNegativeSuffix

getMultiplier

setMultiplier

getGroupingSize

setGroupingSize

isDecimalSeparatorAlwaysShown

setDecimalSeparatorAlwaysShown

isParseBigDecimal

setParseBigDecimal

clone

equals

hashCode

toPattern

toLocalizedPattern

applyPattern

applyLocalizedPattern

setMaximumIntegerDigits

setMinimumIntegerDigits

setMaximumFractionDigits

setMinimumFractionDigits

getMaximumIntegerDigits

getMinimumIntegerDigits

getMaximumFractionDigits

getMinimumFractionDigits

getCurrency

setCurrency

getRoundingMode

setRoundingMode