org.graalvm.shadowed.com.ibm.icu.number

Enum NumberFormatter.SignDisplay

java.lang.Object

java.lang.Enum<NumberFormatter.SignDisplay>

org.graalvm.shadowed.com.ibm.icu.number.NumberFormatter.SignDisplay

All Implemented Interfaces:

Serializable, Comparable<NumberFormatter.SignDisplay>, java.lang.constant.Constable

Enclosing class:

NumberFormatter

public static enum NumberFormatter.SignDisplay
extends Enum<NumberFormatter.SignDisplay>

An enum declaring how to denote positive and negative numbers. Example outputs when formatting 123, 0, and -123 in en-US:

• AUTO: "123", "0", and "-123"
• ALWAYS: "+123", "+0", and "-123"
• NEVER: "123", "0", and "123"
• ACCOUNTING: "$123", "$0", and "($123)"
• ACCOUNTING_ALWAYS: "+$123", "+$0", and "($123)"
• EXCEPT_ZERO: "+123", "0", and "-123"
• ACCOUNTING_EXCEPT_ZERO: "+$123", "$0", and "($123)"

The exact format, including the position and the code point of the sign, differ by locale.

See Also:

NumberFormatter

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Enum

Enum.EnumDesc<E extends Enum<E>>

Enum Constant Summary

Enum Constants

Enum Constant and Description
ACCOUNTING Use the locale-dependent accounting format on negative numbers, and do not show the sign on positive numbers.
ACCOUNTING_ALWAYS Use the locale-dependent accounting format on negative numbers, and show the plus sign on positive numbers, including zero.
ACCOUNTING_EXCEPT_ZERO Use the locale-dependent accounting format on negative numbers, and show the plus sign on positive numbers.
ACCOUNTING_NEGATIVE Same as ACCOUNTING, but do not show the sign on negative zero.
ALWAYS Show the minus sign on negative numbers and the plus sign on positive numbers, including zero.
AUTO Show the minus sign on negative numbers, and do not show the sign on positive numbers.
EXCEPT_ZERO Show the minus sign on negative numbers and the plus sign on positive numbers.
NEGATIVE Same as AUTO, but do not show the sign on negative zero.
NEVER Do not show the sign on positive or negative numbers.

Method Summary

Modifier and Type	Method and Description
static NumberFormatter.SignDisplay	valueOf(String name) Returns the enum constant of this type with the specified name.
static NumberFormatter.SignDisplay[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

AUTO

public static final NumberFormatter.SignDisplay AUTO

Show the minus sign on negative numbers, and do not show the sign on positive numbers. This is the default behavior. If using this option, a sign will be displayed on negative zero, including negative numbers that round to zero. To hide the sign on negative zero, use the NEGATIVE option.

See Also:

NumberFormatter

ALWAYS

public static final NumberFormatter.SignDisplay ALWAYS

Show the minus sign on negative numbers and the plus sign on positive numbers, including zero. To hide the sign on zero, see NumberFormatter.SignDisplay.EXCEPT_ZERO.

See Also:

NumberFormatter

NEVER

public static final NumberFormatter.SignDisplay NEVER

Do not show the sign on positive or negative numbers.

See Also:

NumberFormatter

ACCOUNTING

public static final NumberFormatter.SignDisplay ACCOUNTING

Use the locale-dependent accounting format on negative numbers, and do not show the sign on positive numbers.

The accounting format is defined in CLDR and varies by locale; in many Western locales, the format is a pair of parentheses around the number.

Note: Since CLDR defines the accounting format in the monetary context only, this option falls back to the AUTO sign display strategy when formatting without a currency unit. This limitation may be lifted in the future.

See Also:

NumberFormatter

ACCOUNTING_ALWAYS

public static final NumberFormatter.SignDisplay ACCOUNTING_ALWAYS

Use the locale-dependent accounting format on negative numbers, and show the plus sign on positive numbers, including zero. For more information on the accounting format, see the ACCOUNTING sign display strategy. To hide the sign on zero, see NumberFormatter.SignDisplay.ACCOUNTING_EXCEPT_ZERO.

See Also:

NumberFormatter

EXCEPT_ZERO

public static final NumberFormatter.SignDisplay EXCEPT_ZERO

Show the minus sign on negative numbers and the plus sign on positive numbers. Do not show a sign on zero, numbers that round to zero, or NaN.

See Also:

NumberFormatter

ACCOUNTING_EXCEPT_ZERO

public static final NumberFormatter.SignDisplay ACCOUNTING_EXCEPT_ZERO

Use the locale-dependent accounting format on negative numbers, and show the plus sign on positive numbers. Do not show a sign on zero, numbers that round to zero, or NaN. For more information on the accounting format, see the ACCOUNTING sign display strategy.

See Also:

NumberFormatter

NEGATIVE

public static final NumberFormatter.SignDisplay NEGATIVE

Same as AUTO, but do not show the sign on negative zero.

ACCOUNTING_NEGATIVE

public static final NumberFormatter.SignDisplay ACCOUNTING_NEGATIVE

Same as ACCOUNTING, but do not show the sign on negative zero.

Method Detail

values

public static NumberFormatter.SignDisplay[] values()

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static NumberFormatter.SignDisplay valueOf(String name)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null