Class ScientificNotation

java.lang.Object

com.ibm.icu.number.Notation

com.ibm.icu.number.ScientificNotation

public class ScientificNotation
extends Notation

A class that defines the scientific notation style to be used when formatting numbers in NumberFormatter.

To create a ScientificNotation, use one of the factory methods in Notation.

See Also:

• NumberFormatter

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	ScientificNotation.ScientificHandler
private static class	ScientificNotation.ScientificModifier

Field Summary

Fields

Modifier and Type	Field	Description
(package private) final int	engineeringInterval
(package private) final NumberFormatter.SignDisplay	exponentSignDisplay
(package private) final int	minExponentDigits
(package private) final boolean	requireMinInt

Constructor Summary

Constructors

Constructor	Description
ScientificNotation(int engineeringInterval, boolean requireMinInt, int minExponentDigits, NumberFormatter.SignDisplay exponentSignDisplay)

Method Summary

Modifier and Type	Method	Description
ScientificNotation	withExponentSignDisplay(NumberFormatter.SignDisplay exponentSignDisplay)	Sets whether to show the sign on positive and negative exponents in scientific notation.
(package private) MicroPropsGenerator	withLocaleData(DecimalFormatSymbols symbols, boolean build, MicroPropsGenerator parent)
ScientificNotation	withMinExponentDigits(int minExponentDigits)	Sets the minimum number of digits to show in the exponent of scientific notation, padding with zeros if necessary.

Methods inherited from class Notation

compactLong, compactShort, engineering, scientific, simple

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

engineeringInterval

final int engineeringInterval

requireMinInt

final boolean requireMinInt

minExponentDigits

final int minExponentDigits

exponentSignDisplay

final NumberFormatter.SignDisplay exponentSignDisplay

Constructor Details

ScientificNotation

ScientificNotation(int engineeringInterval,
 boolean requireMinInt,
 int minExponentDigits,
 NumberFormatter.SignDisplay exponentSignDisplay)

Method Details

withMinExponentDigits

public ScientificNotation withMinExponentDigits(int minExponentDigits)

Sets the minimum number of digits to show in the exponent of scientific notation, padding with zeros if necessary. Useful for fixed-width display.

For example, with minExponentDigits=2, the number 123 will be printed as "1.23E02" in en-US instead of the default "1.23E2".

Parameters:

minExponentDigits - The minimum number of digits to show in the exponent.

Returns:

A ScientificNotation, for chaining.

Throws:

IllegalArgumentException - if minExponentDigits is too big or smaller than 1

See Also:

• NumberFormatter

withExponentSignDisplay

public ScientificNotation withExponentSignDisplay(NumberFormatter.SignDisplay exponentSignDisplay)

Sets whether to show the sign on positive and negative exponents in scientific notation. The default is AUTO, showing the minus sign but not the plus sign.

For example, with exponentSignDisplay=ALWAYS, the number 123 will be printed as "1.23E+2" in en-US instead of the default "1.23E2".

Parameters:

exponentSignDisplay - The strategy for displaying the sign in the exponent.

Returns:

A ScientificNotation, for chaining.

See Also:

• NumberFormatter

withLocaleData

MicroPropsGenerator withLocaleData(DecimalFormatSymbols symbols,
 boolean build,
 MicroPropsGenerator parent)