Class LocalizedNumberRangeFormatter

java.lang.Object

com.ibm.icu.number.NumberRangeFormatterSettings<LocalizedNumberRangeFormatter>

com.ibm.icu.number.LocalizedNumberRangeFormatter

public class LocalizedNumberRangeFormatter
extends NumberRangeFormatterSettings<LocalizedNumberRangeFormatter>

A NumberRangeFormatter that has a locale associated with it; this means .formatRange() methods are available.

Instances of this class are immutable and thread-safe.

Author:

sffc

See Also:

• NumberRangeFormatter

Status:

Stable ICU 63.

Method Summary

Modifier and Type	Method	Description
FormattedNumberRange	formatRange(double first, double second)	Format the given doubles to a string using the settings specified in the NumberRangeFormatter fluent setting chain.
FormattedNumberRange	formatRange(int first, int second)	Format the given integers to a string using the settings specified in the NumberRangeFormatter fluent setting chain.
FormattedNumberRange	formatRange(Number first, Number second)	Format the given Numbers to a string using the settings specified in the NumberRangeFormatter fluent setting chain.
UnlocalizedNumberRangeFormatter	withoutLocale()	Disassociate the locale from this formatter.

Methods inherited from class NumberRangeFormatterSettings

collapse, equals, hashCode, identityFallback, numberFormatterBoth, numberFormatterFirst, numberFormatterSecond

Modifier and Type	Method	Description
LocalizedNumberRangeFormatter	collapse(NumberRangeFormatter.RangeCollapse collapse)	Sets the aggressiveness of "collapsing" fields across the range separator.
boolean	equals(Object other)
int	hashCode()
LocalizedNumberRangeFormatter	identityFallback(NumberRangeFormatter.RangeIdentityFallback identityFallback)	Sets the behavior when the two sides of the range are the same.
LocalizedNumberRangeFormatter	numberFormatterBoth(UnlocalizedNumberFormatter formatter)	Sets the NumberFormatter instance to use for the numbers in the range.
LocalizedNumberRangeFormatter	numberFormatterFirst(UnlocalizedNumberFormatter formatterFirst)	Sets the NumberFormatter instance to use for the first number in the range.
LocalizedNumberRangeFormatter	numberFormatterSecond(UnlocalizedNumberFormatter formatterSecond)	Sets the NumberFormatter instances to use for the second number in the range.

Methods inherited from class Object

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

Method Details

formatRange

public FormattedNumberRange formatRange(int first,
 int second)

Format the given integers to a string using the settings specified in the NumberRangeFormatter fluent setting chain.

Parameters:

first - The first number in the range, usually to the left in LTR locales.

second - The second number in the range, usually to the right in LTR locales.

Returns:

A FormattedNumberRange object; call .toString() to get the string.

See Also:

• NumberRangeFormatter

Status:

Stable ICU 63.

formatRange

public FormattedNumberRange formatRange(double first,
 double second)

Format the given doubles to a string using the settings specified in the NumberRangeFormatter fluent setting chain.

Parameters:

first - The first number in the range, usually to the left in LTR locales.

second - The second number in the range, usually to the right in LTR locales.

Returns:

A FormattedNumberRange object; call .toString() to get the string.

See Also:

• NumberRangeFormatter

Status:

Stable ICU 63.

formatRange

public FormattedNumberRange formatRange(Number first,
 Number second)

Format the given Numbers to a string using the settings specified in the NumberRangeFormatter fluent setting chain.

Parameters:

first - The first number in the range, usually to the left in LTR locales.

second - The second number in the range, usually to the right in LTR locales.

Returns:

A FormattedNumberRange object; call .toString() to get the string.

Throws:

IllegalArgumentException - if first or second is null

See Also:

• NumberRangeFormatter

Status:

Stable ICU 63.

withoutLocale

public UnlocalizedNumberRangeFormatter withoutLocale()

Disassociate the locale from this formatter.

Returns:

The fluent chain.

Status:

Stable ICU 74.