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/Scale#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/icu/number/Scale#inhmethods)

# Scale

*** ** * ** ***


`
public


class
Scale
`


`

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


`

`


`

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

<br />

*** ** * ** ***

A class that defines a quantity by which a number should be multiplied when formatting.


To create a Multiplier, use one of the factory methods.
**See also:**

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

## Summary

| ### Public methods ||
|---|---|
| ` static https://developer.android.com/reference/android/icu/number/Scale` | ` https://developer.android.com/reference/android/icu/number/Scale#byBigDecimal(java.math.BigDecimal)(https://developer.android.com/reference/java/math/BigDecimal multiplicand) ` Multiply numbers by an arbitrary value before formatting. |
| ` static https://developer.android.com/reference/android/icu/number/Scale` | ` https://developer.android.com/reference/android/icu/number/Scale#byDouble(double)(double multiplicand) ` Multiply numbers by an arbitrary value before formatting. |
| ` static https://developer.android.com/reference/android/icu/number/Scale` | ` https://developer.android.com/reference/android/icu/number/Scale#byDoubleAndPowerOfTen(double,%20int)(double multiplicand, int power) ` Multiply a number by both a power of ten and by an arbitrary double value before formatting. |
| ` static https://developer.android.com/reference/android/icu/number/Scale` | ` https://developer.android.com/reference/android/icu/number/Scale#none()() ` Do not change the value of numbers when formatting or parsing. |
| ` static https://developer.android.com/reference/android/icu/number/Scale` | ` https://developer.android.com/reference/android/icu/number/Scale#powerOfTen(int)(int power) ` Multiply numbers by 100 before formatting. |

| ### 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

### byBigDecimal

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

```
public static Scale byBigDecimal (BigDecimal multiplicand)
```

Multiply numbers by an arbitrary value before formatting. Useful for unit conversions.


This method takes a BigDecimal; also see the version that takes a double.

<br />

| Parameters ||
|---|---|
| `multiplicand` | `BigDecimal` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/icu/number/Scale` | A Multiplier for passing to the setter in NumberFormatter. <br /> |

**See also:**

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

### byDouble

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

```
public static Scale byDouble (double multiplicand)
```

Multiply numbers by an arbitrary value before formatting. Useful for unit conversions.


This method takes a double; also see the version that takes a BigDecimal.

<br />

| Parameters ||
|---|---|
| `multiplicand` | `double` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/icu/number/Scale` | A Multiplier for passing to the setter in NumberFormatter. <br /> |

**See also:**

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

### byDoubleAndPowerOfTen

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

```
public static Scale byDoubleAndPowerOfTen (double multiplicand, 
                int power)
```

Multiply a number by both a power of ten and by an arbitrary double value before formatting.

<br />

| Parameters ||
|---|---|
| `multiplicand` | `double` <br /> |
| `power` | `int` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/icu/number/Scale` | A Multiplier for passing to the setter in NumberFormatter. <br /> |

**See also:**

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

### none

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

```
public static Scale none ()
```

Do not change the value of numbers when formatting or parsing.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/icu/number/Scale` | A Multiplier to prevent any multiplication. <br /> |

**See also:**

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

### powerOfTen

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

```
public static Scale powerOfTen (int power)
```

Multiply numbers by 100 before formatting. Useful for combining with a percent unit:

```
NumberFormatter.with().unit(NoUnit.PERCENT).multiplier(Multiplier.powerOfTen(2))
```

<br />

<br />

| Parameters ||
|---|---|
| `power` | `int` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/icu/number/Scale` | A Multiplier for passing to the setter in NumberFormatter. <br /> |

**See also:**

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