# IntegerWidth

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

# IntegerWidth

*** ** * ** ***

Kotlin \|[Java](https://developer.android.com/reference/android/icu/number/IntegerWidth "View this page in Java")  

```
open class IntegerWidth
```

|---|--------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                     ||
| ↳ | [android.icu.number.IntegerWidth](https://developer.android.com/reference/kotlin/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.

## Summary

|                                                                                                                                                                                                               Public methods                                                                                                                                                                                                                ||
|--------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| open [IntegerWidth](https://developer.android.com/reference/kotlin/android/icu/number/IntegerWidth#)!        | [truncateAt](https://developer.android.com/reference/kotlin/android/icu/number/IntegerWidth#truncateAt(kotlin.Int))`(`maxInt:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Truncate numbers exceeding a certain number of numerals before the decimal separator.                           |
| open static [IntegerWidth](https://developer.android.com/reference/kotlin/android/icu/number/IntegerWidth#)! | [zeroFillTo](https://developer.android.com/reference/kotlin/android/icu/number/IntegerWidth#zeroFillTo(kotlin.Int))`(`minInt:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Pad numbers at the beginning with zeros to guarantee a certain number of numerals before the decimal separator. |

## Public methods

### truncateAt

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

```
open fun truncateAt(maxInt: Int): IntegerWidth!
```

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](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html): The maximum number of places before the decimal separator. maxInt == -1 means no truncation. |

|                                                                                   Return                                                                                    ||
|--------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
| [IntegerWidth](https://developer.android.com/reference/kotlin/android/icu/number/IntegerWidth#)! | An IntegerWidth for passing to the NumberFormatter integerWidth() setter. |

|                                        Exceptions                                        ||
|--------------------------------------|----------------------------------------------------|
| `java.lang.IllegalArgumentException` | if the input number is too big or smaller than -1. |

**See Also**

- [android.icu.number.NumberFormatter](https://developer.android.com/reference/kotlin/android/icu/number/NumberFormatter)  

### zeroFillTo

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

```
open static fun zeroFillTo(minInt: Int): IntegerWidth!
```

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](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html): The minimum number of places before the decimal separator. |

|                                                                                         Return                                                                                          ||
|--------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------|
| [IntegerWidth](https://developer.android.com/reference/kotlin/android/icu/number/IntegerWidth#)! | An IntegerWidth for chaining or passing to the NumberFormatter integerWidth() setter. |

|                                       Exceptions                                        ||
|--------------------------------------|---------------------------------------------------|
| `java.lang.IllegalArgumentException` | if the input number is too big or smaller than 0. |

**See Also**

- [android.icu.number.NumberFormatter](https://developer.android.com/reference/kotlin/android/icu/number/NumberFormatter)