A significant part of dealing with dates and times is the localization. This class acts as a central point for accessing the information.
- Implementation Requirements:
- This class is immutable and thread-safe.
- Since:
- 1.8
-
Field Summary
Modifier and TypeFieldDescriptionstatic final DecimalStyle
The standard set of non-localized decimal style symbols. -
Method Summary
Modifier and TypeMethodDescriptionboolean
Checks if this DecimalStyle is equal to another DecimalStyle.Lists all the locales that are supported.char
Gets the character that represents the decimal point.char
Gets the character that represents the negative sign.char
Gets the character that represents the positive sign.char
Gets the character that represents zero.int
hashCode()
A hash code for this DecimalStyle.static DecimalStyle
Obtains the DecimalStyle for the specified locale.static DecimalStyle
Obtains the DecimalStyle for the defaultFORMAT
locale.toString()
Returns a string describing this DecimalStyle.withDecimalSeparator
(char decimalSeparator) Returns a copy of the info with a new character that represents the decimal point.withNegativeSign
(char negativeSign) Returns a copy of the info with a new character that represents the negative sign.withPositiveSign
(char positiveSign) Returns a copy of the info with a new character that represents the positive sign.withZeroDigit
(char zeroDigit) Returns a copy of the info with a new character that represents zero.
-
Field Details
-
STANDARD
The standard set of non-localized decimal style symbols.This uses standard ASCII characters for zero, positive, negative and a dot for the decimal point.
-
-
Method Details
-
getAvailableLocales
Lists all the locales that are supported.At a minimum, the returned
Set
must contain aLocale
instance equal toLocale.ROOT
and aLocale
instance equal toLocale.US
.- Returns:
- a Set of Locales for which localization is supported
-
ofDefaultLocale
Obtains the DecimalStyle for the defaultFORMAT
locale.This method provides access to locale sensitive decimal style symbols.
This is equivalent to calling
of(Locale.getDefault(Locale.Category.FORMAT))
.- Returns:
- the decimal style, not null
- See Also:
-
of
Obtains the DecimalStyle for the specified locale.This method provides access to locale sensitive decimal style symbols. If the locale contains "nu" (Numbering System) and/or "rg" (Region Override) Unicode extensions, returned instance will reflect the values specified with those extensions. If both "nu" and "rg" are specified, the value from the "nu" extension supersedes the implicit one from the "rg" extension.
- Parameters:
locale
- the locale, not null- Returns:
- the decimal style, not null
-
getZeroDigit
public char getZeroDigit()Gets the character that represents zero.The character used to represent digits may vary by culture. This method specifies the zero character to use, which implies the characters for one to nine.
- Returns:
- the character for zero
-
withZeroDigit
Returns a copy of the info with a new character that represents zero.The character used to represent digits may vary by culture. This method specifies the zero character to use, which implies the characters for one to nine.
- Parameters:
zeroDigit
- the character for zero- Returns:
- a copy with a new character that represents zero, not null
-
getPositiveSign
public char getPositiveSign()Gets the character that represents the positive sign.The character used to represent a positive number may vary by culture. This method specifies the character to use.
- Returns:
- the character for the positive sign
-
withPositiveSign
Returns a copy of the info with a new character that represents the positive sign.The character used to represent a positive number may vary by culture. This method specifies the character to use.
- Parameters:
positiveSign
- the character for the positive sign- Returns:
- a copy with a new character that represents the positive sign, not null
-
getNegativeSign
public char getNegativeSign()Gets the character that represents the negative sign.The character used to represent a negative number may vary by culture. This method specifies the character to use.
- Returns:
- the character for the negative sign
-
withNegativeSign
Returns a copy of the info with a new character that represents the negative sign.The character used to represent a negative number may vary by culture. This method specifies the character to use.
- Parameters:
negativeSign
- the character for the negative sign- Returns:
- a copy with a new character that represents the negative sign, not null
-
getDecimalSeparator
public char getDecimalSeparator()Gets the character that represents the decimal point.The character used to represent a decimal point may vary by culture. This method specifies the character to use.
- Returns:
- the character for the decimal point
-
withDecimalSeparator
Returns a copy of the info with a new character that represents the decimal point.The character used to represent a decimal point may vary by culture. This method specifies the character to use.
- Parameters:
decimalSeparator
- the character for the decimal point- Returns:
- a copy with a new character that represents the decimal point, not null
-
equals
Checks if this DecimalStyle is equal to another DecimalStyle. -
hashCode
public int hashCode()A hash code for this DecimalStyle. -
toString
Returns a string describing this DecimalStyle.
-