Stay organized with collections
Save and categorize content based on your preferences.
IntegerWidth
public
class
IntegerWidth
extends Object
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 |
|---|
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
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. |
zeroFillTo
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. |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[null,null,["Last updated 2025-02-10 UTC."],[],[],null,["# IntegerWidth\n\nAdded in [API level 30](/guide/topics/manifest/uses-sdk-element#ApiLevels) \nSummary: [Methods](#pubmethods) \\| [Inherited Methods](#inhmethods) \n\nIntegerWidth\n============\n\n*** ** * ** ***\n\n[Kotlin](/reference/kotlin/android/icu/number/IntegerWidth \"View this page in Kotlin\") \\|Java\n\n\n`\npublic\n\n\nclass\nIntegerWidth\n`\n\n\n`\n\nextends `[Object](/reference/java/lang/Object)`\n\n\n`\n\n`\n\n\n`\n\n|---|---------------------------------|\n| [java.lang.Object](/reference/java/lang/Object) ||\n| ↳ | android.icu.number.IntegerWidth |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nA class that defines the strategy for padding and truncating integers before the decimal separator.\n\n\nTo create an IntegerWidth, use one of the factory methods. \n**See also:**\n\n- [NumberFormatter](/reference/android/icu/number/NumberFormatter)\n\nSummary\n-------\n\n| ### Public methods ||\n|----------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` `[IntegerWidth](/reference/android/icu/number/IntegerWidth) | ` `[truncateAt](/reference/android/icu/number/IntegerWidth#truncateAt(int))`(int maxInt) ` Truncate numbers exceeding a certain number of numerals before the decimal separator. |\n| ` static `[IntegerWidth](/reference/android/icu/number/IntegerWidth) | ` `[zeroFillTo](/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. |\n\n| ### Inherited methods |\n|-----------------------|---|\n| From class ` `[java.lang.Object](/reference/java/lang/Object)` ` |---------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](/reference/java/lang/Object) | ` `[clone](/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](/reference/java/lang/Object)` obj) ` Indicates whether some other object is \"equal to\" this one. | | ` void` | ` `[finalize](/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 `[Class](/reference/java/lang/Class)`\u003c?\u003e` | ` `[getClass](/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this `Object`. | | ` int` | ` `[hashCode](/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](/reference/java/lang/String) | ` `[toString](/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](/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` | ` `[wait](/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` | ` `[wait](/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*. | ||\n\nPublic methods\n--------------\n\n### truncateAt\n\nAdded in [API level 30](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic IntegerWidth truncateAt (int maxInt)\n```\n\nTruncate numbers exceeding a certain number of numerals before the decimal separator.\n\nFor example, with maxInt=3, the number 1234 will get printed as \"234\".\n\n\u003cbr /\u003e\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------------------------------------|\n| `maxInt` | `int`: The maximum number of places before the decimal separator. maxInt == -1 means no truncation. \u003cbr /\u003e |\n\n| Returns ||\n|------------------------------------------------------------|----------------------------------------------------------------------------------|\n| [IntegerWidth](/reference/android/icu/number/IntegerWidth) | An IntegerWidth for passing to the NumberFormatter integerWidth() setter. \u003cbr /\u003e |\n\n| Throws ||\n|---------------------------------------------------------------------------|----------------------------------------------------|\n| [IllegalArgumentException](/reference/java/lang/IllegalArgumentException) | if the input number is too big or smaller than -1. |\n\n**See also:**\n\n- [NumberFormatter](/reference/android/icu/number/NumberFormatter) \n\n### zeroFillTo\n\nAdded in [API level 30](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic static IntegerWidth zeroFillTo (int minInt)\n```\n\nPad numbers at the beginning with zeros to guarantee a certain number of numerals before the\ndecimal separator.\n\n\nFor example, with minInt=3, the number 55 will get printed as \"055\".\n\n\u003cbr /\u003e\n\n| Parameters ||\n|----------|--------------------------------------------------------------------------|\n| `minInt` | `int`: The minimum number of places before the decimal separator. \u003cbr /\u003e |\n\n| Returns ||\n|------------------------------------------------------------|----------------------------------------------------------------------------------------------|\n| [IntegerWidth](/reference/android/icu/number/IntegerWidth) | An IntegerWidth for chaining or passing to the NumberFormatter integerWidth() setter. \u003cbr /\u003e |\n\n| Throws ||\n|---------------------------------------------------------------------------|---------------------------------------------------|\n| [IllegalArgumentException](/reference/java/lang/IllegalArgumentException) | if the input number is too big or smaller than 0. |\n\n**See also:**\n\n- [NumberFormatter](/reference/android/icu/number/NumberFormatter)"]]
