- すべての実装されたインタフェース:
Serializable
,Cloneable
- 直系の既知のサブクラス:
ChoiceFormat
,CompactNumberFormat
,DecimalFormat
NumberFormat
は、すべての数値フォーマットに対するabstract基底クラスです。 このクラスは、数値のフォーマットと解析のためのインタフェースです。 さらにNumberFormat
は、数値フォーマットがどのロケールにあり、その名前が何であるかを知るためのメソッドを提供します。
NumberFormat
を使うと、任意のロケールの数値を簡単にフォーマットしたり解析したりできるようになります。 ユーザーのコードは、10進数の小数点、1000の区切り、使用する特定の10進数字に対するロケールのルールだけでなく、数字フォーマットが10進数かどうかということさえも、まったく意識せずに作成できます。
現行ロケールの数値をフォーマットする場合は、ファクトリ・クラス・メソッドの1つを使用します。
複数の数値をフォーマットする場合には、そのフォーマットを取得して、それを複数回使う方が効率的です。そうすれば、ローカルの言語と国のルールをシステムが複数回取得する必要がありません。myString = NumberFormat.getInstance().format(myNumber);
異なるロケールの数値をフォーマットする場合は、NumberFormat nf = NumberFormat.getInstance(); for (int i = 0; i < myNumber.length; ++i) { output.println(nf.format(myNumber[i]) + "; "); }
getInstance
を呼び出すときにそれを指定します。
NumberFormat nf = NumberFormat.getInstance(Locale.FRENCH);
ロケールに"nu" (numbers)および/または"rg" (リージョン・オーバーライド) 「Unicode拡張」が含まれている場合、小数点および/または書式設定に使用される国がオーバーライドされます。 "nu"と"rg"の両方が指定されている場合、"nu"拡張子の小数点は、"rg"拡張子の暗黙のものよりも優先されます。
さらに、NumberFormat
を使って数値を解析することができます。
通常の数値フォーマットを得るには、myNumber = nf.parse(myString);
getInstance
かgetNumberInstance
を使用します。 整数型数値フォーマットを得るには、getIntegerInstance
を使用します。 通貨数値フォーマットを得るには、getCurrencyInstance
を使用します。 getCompactNumberInstance
を使用して、数値をより短い形式で書式設定するために、コンパクト数値書式設定を取得します。 たとえば、2000
はUS locale
内で"2K"
と書式設定できます。 getPercentInstance
を使用して、パーセンテージを表示するための書式を取得します。 このフォーマットを使うと、0.53などの小数点以下は53%のように表示されます。
さらに、setMinimumFractionDigits
などのメソッドを使えば、数値の表示を制御することができます。 フォーマットや解析をより詳細に制御する必要がある場合や、ユーザーに詳細な制御を提供する必要がある場合は、使用するファクトリ・メソッドに応じて、ファクトリ・メソッドからDecimalFormat
またはCompactNumberFormat
にNumberFormat
をキャストすることをお薦めします。 これはほとんどのロケールで有効ですが、有効にならないロケールの場合に備えて、これはtry
ブロックに指定してください。
NumberFormatとDecimalFormatは、フォーマットを制御するものと解析を制御するものがあるように設計されています。 次に、これらの制御メソッドについて詳細に説明します。
setParseIntegerOnlyは解析のみに作用します。たとえば、trueの場合は、"3456.78"→3456 (解析位置をインデックス6の直後にそのまま残しておく)となります。falseの場合は、"3456.78"→3456.78 (解析位置をインデックス8の直後にそのまま残しておく)となります。これはフォーマットに依存しません。 小数点以下の桁がない場合に小数点を表示しないときは、setDecimalSeparatorAlwaysShownを使います。
setDecimalSeparatorAlwaysShownはフォーマットのみに作用します。ただし、"#,##0.##"のようなパターンで、小数点以下の桁がない場合に限ります。たとえば、trueの場合、3456.00→"3,456."となります。falseの場合、3456.00→"3456"となります。これは解析に依存しません。 小数点で解析を停止する場合は、setParseIntegerOnlyを使います。
さらに、parse
とformat
メソッドの形式をParsePosition
とFieldPosition
とともに使用すれば、次のことが可能です。
- 文字列のそれぞれの部分を段階的に解析する
- 小数点などの区域を位置合わせする
- モノスペース・フォントを使い、位置合わせにスペースを入れる場合には、フォーマット呼出しで
FieldPosition
を渡すことができます。このとき、field
=INTEGER_FIELD
とします。 出力では、getEndIndex
が、整数の最後の文字と小数点の間のオフセットに設定されます。 文字列の前に(desiredSpaceCount - getEndIndex)のスペースを追加してください。 - プロポーショナル・フォントを使う場合には、スペースを追加する代わりに、文字列の幅をその始めから
getEndIndex
までピクセル単位で測ります。 次に、テキストを描く前に、(desiredPixelWidth - widthToAlignmentPoint)だけペンを移動します。 これは、小数点を扱うことはできませんが、終わりに追加の文字がある場合にも有効です。たとえば、-12を"(12)"にするように、負の数に括弧を付ける場合です。
Synchronization
数値フォーマットは同期化されません。 スレッドごとに別のフォーマット・インスタンスを作成することをお薦めします。 複数のスレッドがフォーマットに並行してアクセスする場合は、外部的に同期化する必要があります。
- 実装要件:
format(double, StringBuffer, FieldPosition)
、format(long, StringBuffer, FieldPosition)
およびparse(String, ParsePosition)
メソッドは、NullPointerException
のいずれかがnull
の場合、NullPointerException
をスローすることがあります。 サブクラスは、NullPointerException
に関する独自の実装と仕様を提供することができます。デフォルトの実装では、数値の書式設定のために
RoundingMode
で定義された丸めモードが提供されます。 それは「ラウンド半偶数アルゴリズム」を使用します。 丸めモードを変更するには、setRoundingMode
を使用します。 静的ファクトリ・メソッドによって返されたNumberFormat
は、書式構成のために半角丸め(RoundingMode.HALF_EVEN
を参照してください)を使用して浮動小数点数を丸めるように構成されています。- 導入されたバージョン:
- 1.1
- 関連項目:
-
ネストされたクラスのサマリー
修飾子と型クラス説明static class
NumberFormat.formatToCharacterIterator
から返されたAttributedCharacterIterator
内の属性キー、およびFieldPosition
内のフィールド識別子として使用する定数を定義します。static enum
数値書式設定スタイル。 -
フィールドのサマリー
修飾子と型フィールド説明static final int
FieldPositionオブジェクトを構築するためのフィールド定数です。static final int
FieldPositionオブジェクトを構築するためのフィールド定数です。 -
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明clone()
Cloneableをオーバーライドします。boolean
equalsをオーバーライドします。final String
format
(double number) フォーマットの特殊化です。abstract StringBuffer
format
(double number, StringBuffer toAppendTo, FieldPosition pos) フォーマットの特殊化です。final String
format
(long number) フォーマットの特殊化です。abstract StringBuffer
format
(long number, StringBuffer toAppendTo, FieldPosition pos) フォーマットの特殊化です。format
(Object number, StringBuffer toAppendTo, FieldPosition pos) 数値をフォーマットし、その結果のテキストを指定された文字列バッファに追加します。static Locale[]
このクラスのget*Instance
メソッドがローカライズされたインスタンスを返すことのできるロケールすべての配列を返します。static NumberFormat
static NumberFormat
getCompactNumberInstance
(Locale locale, NumberFormat.Style formatStyle) 指定されたlocale
およびformatStyle
に対してコンパクトな数値形式を返します。通貨値のフォーマット時に、この数値フォーマットが使用する通貨を取得します。static final NumberFormat
現在のデフォルトのFORMAT
ロケールに対する通貨フォーマットを返します。static NumberFormat
getCurrencyInstance
(Locale inLocale) 指定されたロケールに対する通貨フォーマットを返します。static final NumberFormat
現在のデフォルトのFORMAT
ロケールに対する汎用数値フォーマットを返します。static NumberFormat
getInstance
(Locale inLocale) 指定されたロケールに対する汎用数値フォーマットを返します。static final NumberFormat
現在のデフォルトのFORMAT
ロケールに対する整数型数値フォーマットを返します。static NumberFormat
getIntegerInstance
(Locale inLocale) 指定されたロケールに対する整数型数値フォーマットを返します。int
数値の小数部分として可能な最大桁数を返します。int
数値の整数部分として可能な最大桁数を返します。int
数値の小数部分として可能な最小桁数を返します。int
数値の整数部分として可能な最小桁数を返します。static final NumberFormat
現在のデフォルトのFORMAT
ロケールに対する汎用数値フォーマットを返します。static NumberFormat
getNumberInstance
(Locale inLocale) 指定されたロケールに対する汎用数値フォーマットを返します。static final NumberFormat
現在のデフォルトのFORMAT
ロケールに対するパーセント・フォーマットを返します。static NumberFormat
getPercentInstance
(Locale inLocale) 指定されたロケールに対するパーセント・フォーマットを返します。このNumberFormatで使用されるRoundingMode
を取得します。int
hashCode()
hashCodeをオーバーライドします。boolean
このフォーマットでグループ化が使用される場合に、trueを返します。boolean
このフォーマットが数値を整数としてのみ解析する場合に、trueを返します。指定された文字列の先頭からテキストを解析して数値を生成します。abstract Number
parse
(String source, ParsePosition parsePosition) 可能な場合([Long.MIN_VALUE, Long.MAX_VALUE]の範囲で、小数部分がない場合など)はLongを、そうでない場合はDoubleを返します。final Object
parseObject
(String source, ParsePosition pos) 文字列からテキストを解析してNumber
を生成します。void
setCurrency
(Currency currency) 通貨値のフォーマット時に、この数値フォーマットが使用する通貨を設定します。void
setGroupingUsed
(boolean newValue) このフォーマットでグループ化を使用するかどうかを設定します。void
setMaximumFractionDigits
(int newValue) 数値の小数部分で許可される最大桁数を設定します。maximumFractionDigitsは、minimumFractionDigits以上である必要があります。void
setMaximumIntegerDigits
(int newValue) 数値の整数部分で許可される最大桁数を設定します。maximumIntegerDigitsは、minimumIntegerDigits以上である必要があります。void
setMinimumFractionDigits
(int newValue) 数値の小数部分で許可される最小桁数を設定します。minimumFractionDigitsは、maximumFractionDigits以下である必要があります。void
setMinimumIntegerDigits
(int newValue) 数値の整数部分で許可される最小桁数を返します。minimumIntegerDigitsは、maximumIntegerDigits以下である必要があります。void
setParseIntegerOnly
(boolean value) 数値を整数としてのみ解析するかどうかを設定します。void
setRoundingMode
(RoundingMode roundingMode) このNumberFormatで使用されるRoundingMode
を設定します。クラス java.text.Formatで宣言されたメソッド
format, formatToCharacterIterator, parseObject
-
フィールド詳細
-
INTEGER_FIELD
public static final int INTEGER_FIELDFieldPositionオブジェクトを構築するためのフィールド定数です。 フォーマットされた数値の整数部分の位置を返すように指定します。- 関連項目:
-
FRACTION_FIELD
public static final int FRACTION_FIELDFieldPositionオブジェクトを構築するためのフィールド定数です。 フォーマットされた数値の小数部分の位置を返すように指定します。- 関連項目:
-
-
コンストラクタの詳細
-
NumberFormat
protected NumberFormat()唯一のコンストラクタです。 (サブクラスのコンストラクタによる呼出し用で、通常は暗黙的に呼び出されます。)
-
-
メソッドの詳細
-
format
public StringBuffer format(Object number, StringBuffer toAppendTo, FieldPosition pos) 数値をフォーマットし、その結果のテキストを指定された文字列バッファに追加します。 指定可能な数値は、Number
の任意のサブクラスです。この実装は、numberから値を抽出する際に、情報の損失なしに
long
に変換可能な整数型の値に対しては、Number.longValue()
を使用します。bit length
が64未満のBigInteger
値もこれに該当します。その他の型に対しては、Number.doubleValue()
を使用します。 続いて、format(long,java.lang.StringBuffer,java.text.FieldPosition)
またはformat(double,java.lang.StringBuffer,java.text.FieldPosition)
を呼び出します。 ただしBigDecimal
値とBigInteger
値の場合は、これにより、その絶対値情報や精度が失われる可能性があります。- 定義:
format
、クラスFormat
- パラメータ:
number
- フォーマットする数値toAppendTo
- フォーマット後のテキストを追加するStringBuffer
pos
- 返された文字列内のフィールドの位置を追跡します。 たとえば、Locale.US
ロケールの番号1234567.89
をフォーマットする場合、指定されたfieldPosition
がINTEGER_FIELD
である場合、fieldPosition
のbeginインデックスとendインデックスは、それぞれ出力文字列1,234,567.89
に対して0と9に設定されます。- 戻り値:
toAppendTo
として渡された値- 例外:
IllegalArgumentException
-number
がnullであるか、Number
のインスタンスでない場合。NullPointerException
-toAppendTo
またはpos
がnullの場合ArithmeticException
- 丸め処理が必要な場合に丸めモードがRoundingMode.UNNECESSARYに設定されているとき- 関連項目:
-
parseObject
public final Object parseObject(String source, ParsePosition pos) 文字列からテキストを解析してNumber
を生成します。メソッドは
pos
によって指定されたインデックスを開始位置としてテキストの解析を試みます。 解析が完了すると、pos
のインデックスは、使用された最後の文字(解析では、文字列の最後までのすべての文字が使用されるとは限らない)のあとのインデックスに更新され、解析された数値が返されます。 更新されたpos
は、このメソッドの次の呼出しの開始点を示すのに使用できます。 エラーが発生した場合は、pos
のインデックスは変更されず、エラーが発生した文字のインデックスにpos
のエラー・インデックスが設定され、nullが返されます。数値の解析の詳細については、
parse(String, ParsePosition)
メソッドを参照してください。- 定義:
parseObject
、クラスFormat
- パラメータ:
source
- 部分的に解析されるString
。pos
- 上記のインデックスおよびエラー・インデックス情報を持つParsePosition
オブジェクト- 戻り値:
- 文字列から解析される
Number
。 エラーの場合はnullを返す。 - 例外:
NullPointerException
-source
またはpos
がnullの場合。
-
format
public final String format(double number) フォーマットの特殊化です。- パラメータ:
number
- フォーマットするdouble数値- 戻り値:
- フォーマットされたString
- 例外:
ArithmeticException
- 丸め処理が必要な場合に丸めモードがRoundingMode.UNNECESSARYに設定されているとき- 関連項目:
-
format
public final String format(long number) フォーマットの特殊化です。- パラメータ:
number
- フォーマットするlong数値- 戻り値:
- フォーマットされたString
- 例外:
ArithmeticException
- 丸め処理が必要な場合に丸めモードがRoundingMode.UNNECESSARYに設定されているとき- 関連項目:
-
format
public abstract StringBuffer format(double number, StringBuffer toAppendTo, FieldPosition pos) フォーマットの特殊化です。- パラメータ:
number
- フォーマットするdouble数値toAppendTo
- フォーマット後のテキストを付加するStringBufferpos
- 返された文字列内のフィールドの位置を追跡します。 たとえば、Locale.US
ロケールの番号1234567.89
をフォーマットする場合、指定されたfieldPosition
がINTEGER_FIELD
である場合、fieldPosition
のbeginインデックスとendインデックスは、それぞれ出力文字列1,234,567.89
に対して0と9に設定されます。- 戻り値:
- フォーマットされたStringBuffer
- 例外:
ArithmeticException
- 丸め処理が必要な場合に丸めモードがRoundingMode.UNNECESSARYに設定されているとき- 関連項目:
-
format
public abstract StringBuffer format(long number, StringBuffer toAppendTo, FieldPosition pos) フォーマットの特殊化です。- パラメータ:
number
- フォーマットするlong数値toAppendTo
- フォーマット後のテキストを付加するStringBufferpos
- 返された文字列内のフィールドの位置を追跡します。 たとえば、Locale.US
ロケールの番号123456789
をフォーマットする場合、指定されたfieldPosition
がINTEGER_FIELD
である場合、fieldPosition
のbeginインデックスとendインデックスは、それぞれ出力文字列123,456,789
に対して0と11に設定されます。- 戻り値:
- フォーマットされたStringBuffer
- 例外:
ArithmeticException
- 丸め処理が必要な場合に丸めモードがRoundingMode.UNNECESSARYに設定されているとき- 関連項目:
-
parse
public abstract Number parse(String source, ParsePosition parsePosition) 可能な場合([Long.MIN_VALUE, Long.MAX_VALUE]の範囲で、小数部分がない場合など)はLongを、そうでない場合はDoubleを返します。 IntegerOnlyが設定されていると、小数点で止まります(または、それと同等のもの、たとえば、分数"1 2/3"では1のあとで止まる)。 例外はスローしません。オブジェクトが解析できない場合、インデックスは変わりません。- パラメータ:
source
- 解析するStringparsePosition
- 解析位置- 戻り値:
- 解析された値
- 関連項目:
-
parse
public Number parse(String source) throws ParseException 指定された文字列の先頭からテキストを解析して数値を生成します。 メソッドは指定された文字列のテキスト全体に使用されない場合もあります。数値の解析の詳細については、
parse(String, ParsePosition)
メソッドを参照してください。- パラメータ:
source
- 先頭が解析されるString
。- 戻り値:
- 文字列から解析される
Number
。 - 例外:
ParseException
- 指定された文字列の先頭が解析できない場合。
-
isParseIntegerOnly
public boolean isParseIntegerOnly()このフォーマットが数値を整数としてのみ解析する場合に、trueを返します。 たとえば、英語ロケールでParseIntegerOnlyがtrueであれば、文字列"1234."は、整数値1234として解析され、解析は文字"."で止まります。 もちろん、解析操作で受け入れられる正確な形式はロケールに依存し、NumberFormatのサブクラスによって決まります。- 戻り値:
- 数値を整数としてのみ解析する場合は
true
、そうでない場合はfalse
-
setParseIntegerOnly
public void setParseIntegerOnly(boolean value) 数値を整数としてのみ解析するかどうかを設定します。- パラメータ:
value
- 数値を整数としてのみ解析する場合はtrue
、そうでない場合はfalse
- 関連項目:
-
getInstance
public static final NumberFormat getInstance()現在のデフォルトのFORMAT
ロケールに対する汎用数値フォーマットを返します。 これは、getNumberInstance()
を呼び出すのと同じです。- 戻り値:
- 汎用の数値書式の
NumberFormat
インスタンス
-
getInstance
public static NumberFormat getInstance(Locale inLocale) 指定されたロケールに対する汎用数値フォーマットを返します。 これは、getNumberInstance(inLocale)
を呼び出すのと同じです。- パラメータ:
inLocale
- 目的のロケール- 戻り値:
- 汎用の数値書式の
NumberFormat
インスタンス
-
getNumberInstance
public static final NumberFormat getNumberInstance()現在のデフォルトのFORMAT
ロケールに対する汎用数値フォーマットを返します。これは、
getNumberInstance(Locale.getDefault(Locale.Category.FORMAT))
の呼び出しと同等です。- 戻り値:
- 汎用の数値書式の
NumberFormat
インスタンス - 関連項目:
-
getNumberInstance
public static NumberFormat getNumberInstance(Locale inLocale) 指定されたロケールに対する汎用数値フォーマットを返します。- パラメータ:
inLocale
- 目的のロケール- 戻り値:
- 汎用の数値書式の
NumberFormat
インスタンス
-
getIntegerInstance
public static final NumberFormat getIntegerInstance()現在のデフォルトのFORMAT
ロケールに対する整数型数値フォーマットを返します。 返された数値フォーマットは、フォーマットするために、最近値方向への丸めモード(RoundingMode.HALF_EVEN
を参照)を使って、浮動小数点数値をもっとも近い整数値に丸め、入力文字列の整数部分だけを解析する(isParseIntegerOnly
を参照)ように設定されます。これは、
getIntegerInstance(Locale.getDefault(Locale.Category.FORMAT))
の呼び出しと同等です。- 戻り値:
- 整数値に対する数値フォーマット
- 導入されたバージョン:
- 1.4
- 関連項目:
-
getIntegerInstance
public static NumberFormat getIntegerInstance(Locale inLocale) 指定されたロケールに対する整数型数値フォーマットを返します。 返された数値フォーマットは、フォーマットするために、最近値方向への丸めモード(RoundingMode.HALF_EVEN
を参照)を使って、浮動小数点数値をもっとも近い整数値に丸め、入力文字列の整数部分だけを解析する(isParseIntegerOnly
を参照)ように設定されます。- パラメータ:
inLocale
- 目的のロケール- 戻り値:
- 整数値に対する数値フォーマット
- 導入されたバージョン:
- 1.4
- 関連項目:
-
getCurrencyInstance
public static final NumberFormat getCurrencyInstance()現在のデフォルトのFORMAT
ロケールに対する通貨フォーマットを返します。これは、
getCurrencyInstance(Locale.getDefault(Locale.Category.FORMAT))
の呼び出しと同等です。- 戻り値:
- 通貨の書式の
NumberFormat
インスタンス - 関連項目:
-
getCurrencyInstance
public static NumberFormat getCurrencyInstance(Locale inLocale) 指定されたロケールに対する通貨フォーマットを返します。指定されたロケールに"
cf
" (「通貨書式スタイル」) 「Unicode拡張」が含まれている場合、戻す通貨書式では、スタイルが使用されます(使用可能な場合)。 それ以外の場合は、スタイルでデフォルトの"standard
"通貨書式が使用されます。 たとえば、スタイルで"account
"が指定されている場合、負の通貨金額では、一部のロケールでカッコのペアが使用されます。- パラメータ:
inLocale
- 目的のロケール- 戻り値:
- 通貨の書式の
NumberFormat
インスタンス
-
getPercentInstance
public static final NumberFormat getPercentInstance()現在のデフォルトのFORMAT
ロケールに対するパーセント・フォーマットを返します。これは、
getPercentInstance(Locale.getDefault(Locale.Category.FORMAT))
の呼び出しと同等です。- 戻り値:
- パーセントの書式の
NumberFormat
インスタンス - 関連項目:
-
getPercentInstance
public static NumberFormat getPercentInstance(Locale inLocale) 指定されたロケールに対するパーセント・フォーマットを返します。- パラメータ:
inLocale
- 目的のロケール- 戻り値:
- パーセントの書式の
NumberFormat
インスタンス
-
getCompactNumberInstance
public static NumberFormat getCompactNumberInstance()- 戻り値:
- コンパクト数値書式設定のための
NumberFormat
インスタンス - 導入されたバージョン:
- 12
- 関連項目:
-
getCompactNumberInstance
public static NumberFormat getCompactNumberInstance(Locale locale, NumberFormat.Style formatStyle) 指定されたlocale
およびformatStyle
に対してコンパクトな数値形式を返します。- パラメータ:
locale
- 目的のロケールformatStyle
- 数値の書式設定用のスタイル- 戻り値:
- コンパクト数値書式設定のための
NumberFormat
インスタンス - 例外:
NullPointerException
-locale
またはformatStyle
がnull
の場合- 導入されたバージョン:
- 12
- 関連項目:
-
getAvailableLocales
public static Locale[] getAvailableLocales()このクラスのget*Instance
メソッドがローカライズされたインスタンスを返すことのできるロケールすべての配列を返します。 返される配列は、JavaランタイムおよびインストールされているNumberFormatProvider
実装によってサポートされているロケールの和集合を表します。 少なくとも、返される配列には、Locale.ROOT
に等しいLocale
インスタンスと、Locale.US
に等しいLocale
インスタンスが含まれている必要があります。- 戻り値:
- ローカライズされた
NumberFormat
インスタンスを使用可能なロケールの配列。
-
hashCode
public int hashCode()hashCodeをオーバーライドします。 -
equals
public boolean equals(Object obj) equalsをオーバーライドします。 -
clone
public Object clone()Cloneableをオーバーライドします。 -
isGroupingUsed
public boolean isGroupingUsed()このフォーマットでグループ化が使用される場合に、trueを返します。 たとえば、英語ロケールでグループ化がオンのとき、数値1234567は、"1,234,567"のようにフォーマットされます。 グループ化セパレータと各グループのサイズはロケールに依存し、NumberFormatのサブクラスによって決まります。- 戻り値:
- グループ化を使用している場合は
true
、そうでない場合はfalse
- 関連項目:
-
setGroupingUsed
public void setGroupingUsed(boolean newValue) このフォーマットでグループ化を使用するかどうかを設定します。- パラメータ:
newValue
- グループ化を使用している場合はtrue
、そうでない場合はfalse
- 関連項目:
-
getMaximumIntegerDigits
public int getMaximumIntegerDigits()数値の整数部分として可能な最大桁数を返します。- 戻り値:
- 最大桁数
- 関連項目:
-
setMaximumIntegerDigits
public void setMaximumIntegerDigits(int newValue) 数値の整数部分で許可される最大桁数を設定します。maximumIntegerDigitsは、minimumIntegerDigits以上である必要があります。 maximumIntegerDigitsの新しい値がmaximumIntegerDigitsの現在の値よりも小さい場合、minimumIntegerDigitsもこの新しい値に設定されます。- パラメータ:
newValue
- 整数の最大表示桁数。0より小さい場合は0が使用される。 具象サブクラスでは、この値の上限を、フォーマットされる数値の種類に適した値に強制できる。- 関連項目:
-
getMinimumIntegerDigits
public int getMinimumIntegerDigits()数値の整数部分として可能な最小桁数を返します。- 戻り値:
- 最小桁数
- 関連項目:
-
setMinimumIntegerDigits
public void setMinimumIntegerDigits(int newValue) 数値の整数部分で許可される最小桁数を返します。minimumIntegerDigitsは、maximumIntegerDigits以下である必要があります。 minimumIntegerDigitsの新しい値がmaximumIntegerDigitsの現在の値よりも大きい場合、maximumIntegerDigitsもこの新しい値に設定されます。- パラメータ:
newValue
- 整数の最小表示桁数。0より小さい場合は0が使用される。 具象サブクラスでは、この値の上限を、フォーマットされる数値の種類に適した値に強制できる。- 関連項目:
-
getMaximumFractionDigits
public int getMaximumFractionDigits()数値の小数部分として可能な最大桁数を返します。- 戻り値:
- 最大桁数。
- 関連項目:
-
setMaximumFractionDigits
public void setMaximumFractionDigits(int newValue) 数値の小数部分で許可される最大桁数を設定します。maximumFractionDigitsは、minimumFractionDigits以上である必要があります。 maximumFractionDigitsの新しい値がminimumFractionDigitsの現在の値よりも小さい場合、minimumFractionDigitsもこの新しい値に設定されます。- パラメータ:
newValue
- 小数部の最大表示桁数。0より小さい場合は0が使用される。 具象サブクラスでは、この値の上限を、フォーマットされる数値の種類に適した値に強制できる。- 関連項目:
-
getMinimumFractionDigits
public int getMinimumFractionDigits()数値の小数部分として可能な最小桁数を返します。- 戻り値:
- 最小桁数
- 関連項目:
-
setMinimumFractionDigits
public void setMinimumFractionDigits(int newValue) 数値の小数部分で許可される最小桁数を設定します。minimumFractionDigitsは、maximumFractionDigits以下である必要があります。 minimumFractionDigitsの新しい値がmaximumFractionDigitsの現在の値を超える場合、maximumFractionDigitsも新しい値に設定されます。- パラメータ:
newValue
- 小数部の最小表示桁数。0より小さい場合は0が使用される。 具象サブクラスでは、この値の上限を、フォーマットされる数値の種類に適した値に強制できる。- 関連項目:
-
getCurrency
public Currency getCurrency()通貨値のフォーマット時に、この数値フォーマットが使用する通貨を取得します。 初期値はロケールに依存する方法で得られます。 有効な通貨が判定されず、setCurrency
を使用して設定された通貨がない場合、nullが返されます。デフォルト実装は
UnsupportedOperationException
をスローします。- 戻り値:
- この数値フォーマットで使用される通貨、または
null
- 例外:
UnsupportedOperationException
- 数値フォーマットのクラスが通貨フォーマットを実装しない場合- 導入されたバージョン:
- 1.4
-
setCurrency
public void setCurrency(Currency currency) 通貨値のフォーマット時に、この数値フォーマットが使用する通貨を設定します。 これは、数値フォーマットが使用する最小小数桁数または最大小数桁数を更新するものではありません。デフォルト実装は
UnsupportedOperationException
をスローします。- パラメータ:
currency
- この数値フォーマットで使用する新しい通貨- 例外:
UnsupportedOperationException
- 数値フォーマットのクラスが通貨フォーマットを実装しない場合NullPointerException
-currency
がnullである場合- 導入されたバージョン:
- 1.4
-
getRoundingMode
public RoundingMode getRoundingMode()このNumberFormatで使用されるRoundingMode
を取得します。 NumberFormatのこのメソッドのデフォルト実装は、常にUnsupportedOperationException
をスローします。 さまざまな丸めモードを処理するサブクラスは、このメソッドをオーバーライドする必要があります。- 戻り値:
- このNumberFormatに使用される
RoundingMode
。 - 例外:
UnsupportedOperationException
- デフォルトの実装は常にこの例外をスローする- 導入されたバージョン:
- 1.6
- 関連項目:
-
setRoundingMode
public void setRoundingMode(RoundingMode roundingMode) このNumberFormatで使用されるRoundingMode
を設定します。 NumberFormatのこのメソッドのデフォルト実装は、常にUnsupportedOperationException
をスローします。 さまざまな丸めモードを処理するサブクラスは、このメソッドをオーバーライドする必要があります。- パラメータ:
roundingMode
- 使用されるRoundingMode
- 例外:
UnsupportedOperationException
- デフォルトの実装は常にこの例外をスローするNullPointerException
-roundingMode
がnullである場合- 導入されたバージョン:
- 1.6
- 関連項目:
-