IntegerWidth

Kotlin |Java

public class IntegerWidth
extends Object

java.lang.Object
↳	android.icu.number.IntegerWidth

A class that defines the strategy for padding and truncating integers before the decimal separator.

To create an IntegerWidth, use one of the factory methods.

See also:

NumberFormatter

Summary

Public methods
`IntegerWidth`	`truncateAt(int maxInt)` Truncate numbers exceeding a certain number of numerals before the decimal separator.
`static IntegerWidth`	`zeroFillTo(int minInt)` Pad numbers at the beginning with zeros to guarantee a certain number of numerals before the decimal separator.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public methods

truncateAt

Added in API level 30

public IntegerWidth truncateAt (int maxInt)

Truncate numbers exceeding a certain number of numerals before the decimal separator. For example, with maxInt=3, the number 1234 will get printed as "234".

Parameters
`maxInt`	`int`: The maximum number of places before the decimal separator. maxInt == -1 means no truncation.

Returns
`IntegerWidth`	An IntegerWidth for passing to the NumberFormatter integerWidth() setter.

Throws
`IllegalArgumentException`	if the input number is too big or smaller than -1.

See also:

NumberFormatter

zeroFillTo

Added in API level 30

public static IntegerWidth zeroFillTo (int minInt)

Pad numbers at the beginning with zeros to guarantee a certain number of numerals before the decimal separator.

For example, with minInt=3, the number 55 will get printed as "055".

Parameters
`minInt`	`int`: The minimum number of places before the decimal separator.

Returns
`IntegerWidth`	An IntegerWidth for chaining or passing to the NumberFormatter integerWidth() setter.

Throws
`IllegalArgumentException`	if the input number is too big or smaller than 0.

See also:

NumberFormatter