モジュール java.base

パッケージ java.text

クラスDecimalFormatSymbols

java.lang.Object

java.text.DecimalFormatSymbols

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

Serializable, Cloneable

public class DecimalFormatSymbols extends Object implements Cloneable, Serializable

このクラスは、数値をフォーマットするときにDecimalFormatで必要となる記号セット(小数点、グループ化区切り文字など)を表します。 DecimalFormatクラスは、それ自体のために、ロケール・データからDecimalFormatSymbolsクラスのインスタンスを生成します。 これらの記号のどれかを変更する必要がある場合は、DecimalFormatからDecimalFormatSymbolsオブジェクトを取得して、修正することができます。

ロケールに"rg" (リージョン・オーバーライド) 「Unicode拡張」が含まれている場合、指定されたリージョンのシンボルはオーバーライドされます。

導入されたバージョン:

1.1

関連項目:

• Locale
• DecimalFormat
• 直列化された形式

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

コンストラクタ

コンストラクタ	説明
DecimalFormatSymbols()	デフォルトFORMATロケールのDecimalFormatSymbolsオブジェクトを生成します。
DecimalFormatSymbols(Locale locale)	指定されたロケールに対してDecimalFormatSymbolsオブジェクトを生成します。

メソッドのサマリー

修飾子と型	メソッド	説明
Object	clone()	標準オーバーライドです。
boolean	equals(Object obj)	指定されたオブジェクトをこのDecimalFormatSymbolsと比較し、等しいかどうかを確認します。
static Locale[]	getAvailableLocales()	このクラスのgetInstanceメソッドがローカライズされたインスタンスを返すことのできるロケールすべての配列を返します。
Currency	getCurrency()	DecimalFormatSymbolsが示す通貨を取得します。
String	getCurrencySymbol()	デフォルト・ロケールで、DecimalFormatSymbolsの通貨に対する通貨記号を返します。
char	getDecimalSeparator()	小数点に使用する文字を取得します。
char	getDigit()	パターンで数字に使用する文字を取得します。
String	getExponentSeparator()	仮数と指数を区切るための文字列を返します。
char	getGroupingSeparator()	区切り文字のグループ化に使用される文字を取得します。
String	getInfinity()	無限大の表示に使用する文字列を取得します。
static final DecimalFormatSymbols	getInstance()	デフォルト・ロケールのDecimalFormatSymbolsインスタンスを取得します。
static final DecimalFormatSymbols	getInstance(Locale locale)	指定されたロケールのDecimalFormatSymbolsインスタンスを取得します。
String	getInternationalCurrencySymbol()	DecimalFormatSymbolsが示す通貨のISO 4217通貨コードを返します。
Locale	getLocale()	このインスタンスの作成に使用するロケールを返します。
char	getMinusSign()	負符号の表示に使用する文字を取得します。
char	getMonetaryDecimalSeparator()	通貨桁区切り文字を返します。
char	getMonetaryGroupingSeparator()	通貨の区切り文字のグループ化に使用される文字を取得します。
String	getNaN()	「非数」の表示に使用する文字列を取得します。
char	getPatternSeparator()	パターンにおいて正のサブパターンと負のサブパターンを区切るために使用する文字を取得します。
char	getPercent()	パーセント符号に使用する文字を取得します。
char	getPerMill()	パーミル符号に使用する文字を取得します。
char	getZeroDigit()	ゼロに使用する文字を取得します。
int	hashCode()	このDecimalFormatSymbolsのハッシュ・コードを返します。
void	setCurrency(Currency currency)	DecimalFormatSymbolsが示す通貨を設定します。
void	setCurrencySymbol(String currency)	デフォルト・ロケールで、DecimalFormatSymbolsの通貨に対する通貨記号を設定します。
void	setDecimalSeparator(char decimalSeparator)	小数点に使用する文字を設定します。
void	setDigit(char digit)	パターンで数字に使用する文字を設定します。
void	setExponentSeparator(String exp)	仮数と指数を区切るための文字列を設定します。
void	setGroupingSeparator(char groupingSeparator)	区切り文字のグループ化に使用する文字を設定します。
void	setInfinity(String infinity)	無限大の表示に使用する文字列を設定します。
void	setInternationalCurrencySymbol(String currencyCode)	DecimalFormatSymbolsが示す通貨のISO 4217通貨コードを設定します。
void	setMinusSign(char minusSign)	負符号の表示に使用する文字を設定します。
void	setMonetaryDecimalSeparator(char sep)	通貨桁区切り文字を設定します。
void	setMonetaryGroupingSeparator(char monetaryGroupingSeparator)	通貨の区切り文字のグループ化に使用する文字を設定します。
void	setNaN(String NaN)	「非数」の表示に使用する文字列を設定します。
void	setPatternSeparator(char patternSeparator)	パターンにおいて正のサブパターンと負のサブパターンを区切るために使用する文字を設定します。
void	setPercent(char percent)	パーセント符号に使用する文字を設定します。
void	setPerMill(char perMill)	パーミル符号に使用する文字を設定します。
void	setZeroDigit(char zeroDigit)	ゼロに使用する文字を設定します。

クラスjava.lang.Objectで宣言されたメソッド

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

DecimalFormatSymbols

public DecimalFormatSymbols()

デフォルトFORMATロケールのDecimalFormatSymbolsオブジェクトを生成します。 このコンストラクタでは、Java実行環境でサポートされているロケールについてのみ、インスタンスを構築できます。インストールされているDecimalFormatSymbolsProvider実装でサポートされているロケールについては、インスタンスを構築できません。 すべてのロケールをカバーするには、getInstanceメソッドを使用してください。

これは、DecimalFormatSymbols(Locale.getDefault(Locale.Category.FORMAT))の呼び出しと同等です。

関連項目:

• Locale.getDefault(java.util.Locale.Category)
• Locale.Category.FORMAT

DecimalFormatSymbols

public DecimalFormatSymbols(Locale locale)

指定されたロケールに対してDecimalFormatSymbolsオブジェクトを生成します。 このコンストラクタでは、Java実行環境でサポートされているロケールについてのみ、インスタンスを構築できます。インストールされているDecimalFormatSymbolsProvider実装でサポートされているロケールについては、インスタンスを構築できません。 すべてのロケールをカバーするには、getInstanceメソッドを使用してください。 指定されたロケールがその数体系用にLocale.UNICODE_LOCALE_EXTENSIONを含んでいる場合、インスタンスは指定された数体系で初期化されます(JRE実装がその数体系をサポートする場合)。 たとえば、

 NumberFormat.getNumberInstance(Locale.forLanguageTag("th-TH-u-nu-thai"))
 

これは、ラテン語数体系のかわりにタイ語数体系を使用したNumberFormatインスタンスを返す場合があります。

パラメータ:

locale - 目的のロケール

例外:

NullPointerException - localeがnullである場合

メソッドの詳細

getAvailableLocales

public static Locale[] getAvailableLocales()

このクラスのgetInstanceメソッドがローカライズされたインスタンスを返すことのできるロケールすべての配列を返します。 返される配列は、JavaランタイムおよびインストールされているDecimalFormatSymbolsProvider実装によってサポートされているロケールの和集合を表します。 少なくとも、返される配列には、Locale.ROOTに等しいLocaleインスタンスと、Locale.USに等しいLocaleインスタンスが含まれている必要があります。

戻り値:

ローカライズされたDecimalFormatSymbolsインスタンスを使用可能なロケールの配列。

導入されたバージョン:

1.6

getInstance

public static final DecimalFormatSymbols getInstance()

デフォルト・ロケールのDecimalFormatSymbolsインスタンスを取得します。 このメソッドを使用すると、Javaランタイム自体でサポートされているロケールと、インストールされているDecimalFormatSymbolsProvider実装でサポートされているロケールの、DecimalFormatSymbolsインスタンスにアクセスできます。

これは、getInstance(Locale.getDefault(Locale.Category.FORMAT))の呼び出しと同等です。

戻り値:

DecimalFormatSymbolsのインスタンス。

導入されたバージョン:

1.6

関連項目:

• Locale.getDefault(java.util.Locale.Category)
• Locale.Category.FORMAT

getInstance

public static final DecimalFormatSymbols getInstance(Locale locale)

指定されたロケールのDecimalFormatSymbolsインスタンスを取得します。 このメソッドを使用すると、Javaランタイム自体でサポートされているロケールと、インストールされているDecimalFormatSymbolsProvider実装でサポートされているロケールの、DecimalFormatSymbolsインスタンスにアクセスできます。 指定されたロケールがその数体系用にLocale.UNICODE_LOCALE_EXTENSIONを含んでいる場合、インスタンスは指定された数体系で初期化されます(JRE実装がその数体系をサポートする場合)。 たとえば、

 NumberFormat.getNumberInstance(Locale.forLanguageTag("th-TH-u-nu-thai"))
 

これは、ラテン語数体系のかわりにタイ語数体系を使用したNumberFormatインスタンスを返す場合があります。

パラメータ:

locale - 目的のロケール。

戻り値:

DecimalFormatSymbolsのインスタンス。

例外:

NullPointerException - localeがnullである場合

導入されたバージョン:

1.6

getLocale

public Locale getLocale()

このインスタンスの作成に使用するロケールを返します。

戻り値:

このインスタンスの作成に使用されるロケール

導入されたバージョン:

19

getZeroDigit

public char getZeroDigit()

ゼロに使用する文字を取得します。 アラビア語などでは異なるものを使用します。

戻り値:

ゼロに使用する文字

setZeroDigit

public void setZeroDigit(char zeroDigit)

ゼロに使用する文字を設定します。 アラビア語などでは異なるものを使用します。

パラメータ:

zeroDigit - ゼロに使用する文字

getGroupingSeparator

public char getGroupingSeparator()

区切り文字のグループ化に使用される文字を取得します。 フランス語などでは異なるものを使用します。

戻り値:

グループ区切り文字

setGroupingSeparator

public void setGroupingSeparator(char groupingSeparator)

区切り文字のグループ化に使用する文字を設定します。 フランス語などでは異なるものを使用します。

パラメータ:

groupingSeparator - グループ区切り文字

getDecimalSeparator

public char getDecimalSeparator()

小数点に使用する文字を取得します。 フランス語などでは異なるものを使用します。

戻り値:

小数点に使用する文字

setDecimalSeparator

public void setDecimalSeparator(char decimalSeparator)

小数点に使用する文字を設定します。 フランス語などでは異なるものを使用します。

パラメータ:

decimalSeparator - 小数点に使用する文字

getPerMill

public char getPerMill()

パーミル符号に使用する文字を取得します。 アラビア語などでは異なるものを使用します。

戻り値:

パーミル符号に使用する文字

setPerMill

public void setPerMill(char perMill)

パーミル符号に使用する文字を設定します。 アラビア語などでは異なるものを使用します。

パラメータ:

perMill - パーミル符号に使用する文字

getPercent

public char getPercent()

パーセント符号に使用する文字を取得します。 アラビア語などでは異なるものを使用します。

戻り値:

パーセント符号に使用する文字

setPercent

public void setPercent(char percent)

パーセント符号に使用する文字を設定します。 アラビア語などでは異なるものを使用します。

パラメータ:

percent - パーミル符号に使用する文字

getDigit

public char getDigit()

パターンで数字に使用する文字を取得します。

戻り値:

パターンで数字に使用する文字

setDigit

public void setDigit(char digit)

パターンで数字に使用する文字を設定します。

パラメータ:

digit - パターンで数字に使用する文字

getPatternSeparator

public char getPatternSeparator()

パターンにおいて正のサブパターンと負のサブパターンを区切るために使用する文字を取得します。

戻り値:

パターン区切り文字

setPatternSeparator

public void setPatternSeparator(char patternSeparator)

パターンにおいて正のサブパターンと負のサブパターンを区切るために使用する文字を設定します。

パラメータ:

patternSeparator - パターン区切り文字

getInfinity

public String getInfinity()

無限大の表示に使用する文字列を取得します。 これは、ほとんどの場合変更されません。

戻り値:

無限大を表す文字列

setInfinity

public void setInfinity(String infinity)

無限大の表示に使用する文字列を設定します。 これは、ほとんどの場合変更されません。

パラメータ:

infinity - 無限大を表す文字列

getNaN

public String getNaN()

「非数」の表示に使用する文字列を取得します。 これは、ほとんどの場合変更されません。

戻り値:

「非数」を表す文字列

setNaN

public void setNaN(String NaN)

「非数」の表示に使用する文字列を設定します。 これは、ほとんどの場合変更されません。

パラメータ:

NaN - 「非数」を表す文字列

getMinusSign

public char getMinusSign()

負符号の表示に使用する文字を取得します。 負のフォーマットを明示的に指定しない場合は、正のフォーマットの前に負符号が付けられます。

戻り値:

負符号を表す文字

setMinusSign

public void setMinusSign(char minusSign)

負符号の表示に使用する文字を設定します。 負のフォーマットを明示的に指定しない場合は、正のフォーマットの前に負符号が付けられます。

パラメータ:

minusSign - 負符号を表す文字

getCurrencySymbol

public String getCurrencySymbol()

デフォルト・ロケールで、DecimalFormatSymbolsの通貨に対する通貨記号を返します。

戻り値:

通貨記号

導入されたバージョン:

1.2

setCurrencySymbol

public void setCurrencySymbol(String currency)

デフォルト・ロケールで、DecimalFormatSymbolsの通貨に対する通貨記号を設定します。

パラメータ:

currency - 通貨記号

導入されたバージョン:

1.2

getInternationalCurrencySymbol

public String getInternationalCurrencySymbol()

DecimalFormatSymbolsが示す通貨のISO 4217通貨コードを返します。

戻り値:

通貨コード

導入されたバージョン:

1.2

setInternationalCurrencySymbol

public void setInternationalCurrencySymbol(String currencyCode)

DecimalFormatSymbolsが示す通貨のISO 4217通貨コードを設定します。 通貨コードが有効な場合(Currency.getInstanceで定義される)は、対応するCurrencyインスタンスに対する通貨属性と、DecimalFormatSymbolsのロケールでの通貨記号に対する通貨記号属性も設定します。 通貨コードが無効の場合は、通貨属性はnullに設定され、通貨記号属性は変更されません。

パラメータ:

currencyCode - 通貨コード

導入されたバージョン:

1.2

関連項目:

• setCurrency(java.util.Currency)
• setCurrencySymbol(java.lang.String)

getCurrency

public Currency getCurrency()

DecimalFormatSymbolsが示す通貨を取得します。 通貨記号属性が、有効なISO 4217通貨コード以外の値にあらかじめ設定された通貨記号属性の場合は、nullになります。

戻り値:

使用される通貨またはnull

導入されたバージョン:

1.4

setCurrency

public void setCurrency(Currency currency)

DecimalFormatSymbolsが示す通貨を設定します。 通貨記号属性を、DecimalFormatSymbolsのロケールでの通貨の記号に設定し、国際通貨記号属性を通貨のISO 4217通貨コードに設定します。

パラメータ:

currency - 使用する新しい通貨

例外:

NullPointerException - currencyがnullである場合

導入されたバージョン:

1.4

関連項目:

• setCurrencySymbol(java.lang.String)
• setInternationalCurrencySymbol(java.lang.String)

getMonetaryDecimalSeparator

public char getMonetaryDecimalSeparator()

通貨桁区切り文字を返します。

戻り値:

通貨桁区切り文字

導入されたバージョン:

1.2

setMonetaryDecimalSeparator

public void setMonetaryDecimalSeparator(char sep)

通貨桁区切り文字を設定します。

パラメータ:

sep - 通貨桁区切り文字

導入されたバージョン:

1.2

getExponentSeparator

public String getExponentSeparator()

仮数と指数を区切るための文字列を返します。 例1.23x10^4の「x10^」、1.23E4の「E」。

戻り値:

指数区切り文字列

導入されたバージョン:

1.6

関連項目:

• setExponentSeparator(java.lang.String)

setExponentSeparator

public void setExponentSeparator(String exp)

仮数と指数を区切るための文字列を設定します。 例1.23x10^4の「x10^」、1.23E4の「E」。

パラメータ:

exp - 指数区切り文字列

例外:

NullPointerException - expがnullである場合

導入されたバージョン:

1.6

関連項目:

• getExponentSeparator()

getMonetaryGroupingSeparator

public char getMonetaryGroupingSeparator()

通貨の区切り文字のグループ化に使用される文字を取得します。 一部のロケール(オーストリアのドイツ語など)では、grouping separatorと異なる場合があります。

戻り値:

通貨グループ・セパレータ

導入されたバージョン:

15

setMonetaryGroupingSeparator

public void setMonetaryGroupingSeparator(char monetaryGroupingSeparator)

通貨の区切り文字のグループ化に使用する文字を設定します。 このメソッドを呼び出しても、通常のgrouping separatorには影響しません。

パラメータ:

monetaryGroupingSeparator - 通貨グループ・セパレータ

導入されたバージョン:

15

関連項目:

• setGroupingSeparator(char)

clone

public Object clone()

標準オーバーライドです。

オーバーライド:

clone、クラスObject

戻り値:

このインスタンスの複製。

関連項目:

• Cloneable

equals

public boolean equals(Object obj)

指定されたオブジェクトをこのDecimalFormatSymbolsと比較し、等しいかどうかを確認します。 オブジェクトがDecimalFormatSymbolsでもあり、2つのDecimalFormatSymbolsオブジェクトが同じシンボルのセットを表す場合、trueを返します。

オーバーライド:

equals、クラスObject

実装要件:

このメソッドは、instanceofではなく、getClass()に基づくクラス・アイデンティティの概念を使用して等価チェックを実行します。 したがって、サブクラスのequalsメソッドでは、このクラスのインスタンスはサブクラスのインスタンスと等しく比較されません。

パラメータ:

obj - 等価性のために比較されるオブジェクト

戻り値:

指定されたオブジェクトがこのDecimalFormatSymbolsと等しい場合はtrue

関連項目:

• Object.equals(Object)

hashCode

public int hashCode()

このDecimalFormatSymbolsのハッシュ・コードを返します。

オーバーライド:

hashCode、クラスObject

実装要件:

このクラスの非一時インスタンス・フィールドは、Objects.hashCode(java.lang.Object)で定義された契約に準拠するハッシュ・コード値の計算に使用されます。

戻り値:

このDecimalFormatSymbolsのハッシュ・コード

関連項目:

• Object.hashCode()