# NumberRangeFormatter.RangeCollapse

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

# RangeCollapse

*** ** * ** ***

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

```
class RangeCollapse
```

|---|---|----------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                                                                    |||
| ↳ | [kotlin.Enum](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-enum/index.html)\<[android.icu.number.NumberRangeFormatter.RangeCollapse](https://developer.android.com/reference/kotlin/android/icu/number/NumberRangeFormatter.RangeCollapse#)\> ||
|   | ↳ | [android.icu.number.NumberRangeFormatter.RangeCollapse](https://developer.android.com/reference/kotlin/android/icu/number/NumberRangeFormatter.RangeCollapse#) |

|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Known Direct Subclasses [NumberRangeFormatter.RangeCollapse.ALL](https://developer.android.com/reference/kotlin/android/icu/number/NumberRangeFormatter.RangeCollapse#ENUM_VALUE:ALL),[NumberRangeFormatter.RangeCollapse.AUTO](https://developer.android.com/reference/kotlin/android/icu/number/NumberRangeFormatter.RangeCollapse#ENUM_VALUE:AUTO),[NumberRangeFormatter.RangeCollapse.NONE](https://developer.android.com/reference/kotlin/android/icu/number/NumberRangeFormatter.RangeCollapse#ENUM_VALUE:NONE),[NumberRangeFormatter.RangeCollapse.UNIT](https://developer.android.com/reference/kotlin/android/icu/number/NumberRangeFormatter.RangeCollapse#ENUM_VALUE:UNIT) |-----------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------| | [NumberRangeFormatter.RangeCollapse.ALL](https://developer.android.com/reference/kotlin/android/icu/number/NumberRangeFormatter.RangeCollapse#ENUM_VALUE:ALL)   | Collapse any field that is equal across the range sign.                         | | [NumberRangeFormatter.RangeCollapse.AUTO](https://developer.android.com/reference/kotlin/android/icu/number/NumberRangeFormatter.RangeCollapse#ENUM_VALUE:AUTO) | Use locale data and heuristics to determine how much of the string to collapse. | | [NumberRangeFormatter.RangeCollapse.NONE](https://developer.android.com/reference/kotlin/android/icu/number/NumberRangeFormatter.RangeCollapse#ENUM_VALUE:NONE) | Do not collapse any part of the number.                                         | | [NumberRangeFormatter.RangeCollapse.UNIT](https://developer.android.com/reference/kotlin/android/icu/number/NumberRangeFormatter.RangeCollapse#ENUM_VALUE:UNIT) | Collapse the unit part of the number, but not the notation, if present.         | |

Defines how to merge fields that are identical across the range sign.

## Summary

|                                                                                                   Enum values                                                                                                   ||
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| [ALL](https://developer.android.com/reference/kotlin/android/icu/number/NumberRangeFormatter.RangeCollapse#ENUM_VALUE:ALL) Collapse any field that is equal across the range sign.                           |
| [AUTO](https://developer.android.com/reference/kotlin/android/icu/number/NumberRangeFormatter.RangeCollapse#ENUM_VALUE:AUTO) Use locale data and heuristics to determine how much of the string to collapse. |
| [NONE](https://developer.android.com/reference/kotlin/android/icu/number/NumberRangeFormatter.RangeCollapse#ENUM_VALUE:NONE) Do not collapse any part of the number.                                         |
| [UNIT](https://developer.android.com/reference/kotlin/android/icu/number/NumberRangeFormatter.RangeCollapse#ENUM_VALUE:UNIT) Collapse the unit part of the number, but not the notation, if present.         |

## Enum values

### ALL

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

```
enum val ALL : NumberRangeFormatter.RangeCollapse
```

Collapse any field that is equal across the range sign. May introduce ambiguity on the magnitude of the number. Example: "3.2 -- 5.3 thousand kilograms"  
**See Also**

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

### AUTO

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

```
enum val AUTO : NumberRangeFormatter.RangeCollapse
```

Use locale data and heuristics to determine how much of the string to collapse. Could end up collapsing none, some, or all repeated pieces in a locale-sensitive way.

The heuristics used for this option are subject to change over time.  
**See Also**

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

### NONE

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

```
enum val NONE : NumberRangeFormatter.RangeCollapse
```

Do not collapse any part of the number. Example: "3.2 thousand kilograms -- 5.3 thousand kilograms"  
**See Also**

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

### UNIT

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

```
enum val UNIT : NumberRangeFormatter.RangeCollapse
```

Collapse the unit part of the number, but not the notation, if present. Example: "3.2 thousand -- 5.3 thousand kilograms"  
**See Also**

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