()

Returns an array of all locales for which the

methods of this class can return localized instances. The returned array represents the union of locales supported by the Java runtime and by installed

implementations. It must contain at least a

instance equal to

.

Returns:

an array of locales for which localized DecimalFormatSymbols instances are available.

Since:

1.6

Returns:

a DecimalFormatSymbols instance.

Since:

1.6

See Also:

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

Gets the

instance for the specified locale. This method provides access to

instances for locales supported by the Java runtime itself as well as for those supported by installed

implementations. If the specified locale contains the

for the numbering system, the instance is initialized with the specified numbering system if the JRE implementation supports it. For example,

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

This may return a

instance with the Thai numbering system, instead of the Latin numbering system.

Parameters:

locale - the desired locale.

Returns:

a DecimalFormatSymbols instance.

Throws:

NullPointerException - if locale is null

Since:

1.6

public char getZeroDigit()

Gets the character used for zero. Different for Arabic, etc.

Returns:

the character used for zero

public void setZeroDigit(char zeroDigit)

Sets the character used for zero. Different for Arabic, etc.

Parameters:

zeroDigit - the character used for zero

public char getGroupingSeparator()

Gets the character used for grouping separator. Different for French, etc.

Returns:

the grouping separator

public void setGroupingSeparator(char groupingSeparator)

Sets the character used for grouping separator. Different for French, etc.

Parameters:

groupingSeparator - the grouping separator

public char getDecimalSeparator()

Gets the character used for decimal sign. Different for French, etc.

Returns:

the character used for decimal sign

public void setDecimalSeparator(char decimalSeparator)

Sets the character used for decimal sign. Different for French, etc.

Parameters:

decimalSeparator - the character used for decimal sign

public char getPerMill()

Gets the character used for per mille sign. Different for Arabic, etc.

Returns:

the character used for per mille sign

public void setPerMill(char perMill)

Sets the character used for per mille sign. Different for Arabic, etc.

Parameters:

perMill - the character used for per mille sign

public char getPercent()

Gets the character used for percent sign. Different for Arabic, etc.

Returns:

the character used for percent sign

public void setPercent(char percent)

Sets the character used for percent sign. Different for Arabic, etc.

Parameters:

percent - the character used for percent sign

public char getDigit()

Gets the character used for a digit in a pattern.

Returns:

the character used for a digit in a pattern

public void setDigit(char digit)

Sets the character used for a digit in a pattern.

Parameters:

digit - the character used for a digit in a pattern

public char getPatternSeparator()

Gets the character used to separate positive and negative subpatterns in a pattern.

Returns:

the pattern separator

public void setPatternSeparator(char patternSeparator)

Sets the character used to separate positive and negative subpatterns in a pattern.

Parameters:

patternSeparator - the pattern separator

Gets the string used to represent infinity. Almost always left unchanged.

Returns:

the string representing infinity

Sets the string used to represent infinity. Almost always left unchanged.

Parameters:

infinity - the string representing infinity

Gets the string used to represent "not a number". Almost always left unchanged.

Returns:

the string representing "not a number"

Sets the string used to represent "not a number". Almost always left unchanged.

Parameters:

NaN - the string representing "not a number"

public char getMinusSign()

Gets the character used to represent minus sign. If no explicit negative format is specified, one is formed by prefixing minusSign to the positive format.

Returns:

the character representing minus sign

public void setMinusSign(char minusSign)

Sets the character used to represent minus sign. If no explicit negative format is specified, one is formed by prefixing minusSign to the positive format.

Parameters:

minusSign - the character representing minus sign

()

Returns the currency symbol for the currency of these DecimalFormatSymbols in their locale.

Returns:

the currency symbol

Since:

1.2

Sets the currency symbol for the currency of these DecimalFormatSymbols in their locale.

Parameters:

currency - the currency symbol

Since:

1.2

()

Returns the ISO 4217 currency code of the currency of these DecimalFormatSymbols.

Returns:

the currency code

Since:

1.2

Sets the ISO 4217 currency code of the currency of these DecimalFormatSymbols. If the currency code is valid (as defined by

), this also sets the currency attribute to the corresponding Currency instance and the currency symbol attribute to the currency's symbol in the DecimalFormatSymbols' locale. If the currency code is not valid, then the currency attribute is set to null and the currency symbol attribute is not modified.

Parameters:

currencyCode - the currency code

Since:

1.2

See Also:

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

Gets the currency of these DecimalFormatSymbols. May be null if the currency symbol attribute was previously set to a value that's not a valid ISO 4217 currency code.

Returns:

the currency used, or null

Since:

1.4

Sets the currency of these DecimalFormatSymbols. This also sets the currency symbol attribute to the currency's symbol in the DecimalFormatSymbols' locale, and the international currency symbol attribute to the currency's ISO 4217 currency code.

Parameters:

currency - the new currency to be used

Throws:

NullPointerException - if currency is null

Since:

1.4

See Also:

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

public char getMonetaryDecimalSeparator()

Returns the monetary decimal separator.

Returns:

the monetary decimal separator

Since:

1.2

public void setMonetaryDecimalSeparator(char sep)

Sets the monetary decimal separator.

Parameters:

sep - the monetary decimal separator

Since:

1.2

()

Returns the string used to separate the mantissa from the exponent. Examples: "x10^" for 1.23x10^4, "E" for 1.23E4.

Returns:

the exponent separator string

Since:

1.6

See Also:

• setExponentSeparator(java.lang.String)

Sets the string used to separate the mantissa from the exponent. Examples: "x10^" for 1.23x10^4, "E" for 1.23E4.

Parameters:

exp - the exponent separator string

Throws:

NullPointerException - if exp is null

Since:

1.6

See Also:

• getExponentSeparator()

public char getMonetaryGroupingSeparator()

Gets the character used for grouping separator for currencies. May be different from grouping separator in some locales, e.g, German in Austria.

Returns:

the monetary grouping separator

Since:

15

public void setMonetaryGroupingSeparator(char monetaryGroupingSeparator)

Sets the character used for grouping separator for currencies. Invocation of this method will not affect the normal grouping separator.

Parameters:

monetaryGroupingSeparator - the monetary grouping separator

Since:

15

See Also:

• setGroupingSeparator(char)

Standard override.

Overrides:

clone in class Object

Returns:

a clone of this instance.

See Also:

• Cloneable

Override equals.

Overrides:

equals in class Object

Parameters:

obj - the reference object with which to compare.

Returns:

true if this object is the same as the obj argument; false otherwise.

See Also:

• Object.hashCode()
• HashMap

public int hashCode()

Override hashCode.

Overrides:

hashCode in class Object

Returns:

a hash code value for this object.

See Also:

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)