Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Methods](https://developer.android.com/reference/android/icu/number/IntegerWidth#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/icu/number/IntegerWidth#inhmethods)

# IntegerWidth

*** ** * ** ***


`
public


class
IntegerWidth
`


`

extends https://developer.android.com/reference/java/lang/Object


`

`


`

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.icu.number.IntegerWidth |

<br />

*** ** * ** ***

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:**

- `https://developer.android.com/reference/android/icu/number/NumberFormatter`

## Summary

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/android/icu/number/IntegerWidth` | ` https://developer.android.com/reference/android/icu/number/IntegerWidth#truncateAt(int)(int maxInt) ` Truncate numbers exceeding a certain number of numerals before the decimal separator. |
| ` static https://developer.android.com/reference/android/icu/number/IntegerWidth` | ` https://developer.android.com/reference/android/icu/number/IntegerWidth#zeroFillTo(int)(int minInt) ` Pad numbers at the beginning with zeros to guarantee a certain number of numerals before the decimal separator. |

| ### Inherited methods |
|---|---|
| From class ` https://developer.android.com/reference/java/lang/Object ` |---|---| | ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/java/lang/Object#clone()() ` Creates and returns a copy of this object. | | ` boolean` | ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` https://developer.android.com/reference/java/lang/Object#finalize()() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final https://developer.android.com/reference/java/lang/Class<?>` | ` https://developer.android.com/reference/java/lang/Object#getClass()() ` Returns the runtime class of this `Object`. | | ` int` | ` https://developer.android.com/reference/java/lang/Object#hashCode()() ` Returns a hash code value for the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notify()() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notifyAll()() ` Wakes up all threads that are waiting on this object's monitor. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Object#toString()() ` Returns a string representation of the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(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` | ` https://developer.android.com/reference/java/lang/Object#wait(long)(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` | ` https://developer.android.com/reference/java/lang/Object#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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
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".

<br />

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

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/icu/number/IntegerWidth` | An IntegerWidth for passing to the NumberFormatter integerWidth() setter. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if the input number is too big or smaller than -1. |

**See also:**

- `https://developer.android.com/reference/android/icu/number/NumberFormatter`

### zeroFillTo

Added in [API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
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".

<br />

| Parameters ||
|---|---|
| `minInt` | `int`: The minimum number of places before the decimal separator. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/icu/number/IntegerWidth` | An IntegerWidth for chaining or passing to the NumberFormatter integerWidth() setter. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if the input number is too big or smaller than 0. |

**See also:**

- `https://developer.android.com/reference/android/icu/number/NumberFormatter`