# android.icu.util

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

# android.icu.util

*** ** * ** ***

[Kotlin](https://developer.android.com/reference/kotlin/android/icu/util/package-summary "View this page in Kotlin")\|Java

## Interfaces

|---------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Freezable](https://developer.android.com/reference/android/icu/util/Freezable)\<T\>              | Provides a flexible mechanism for controlling access, without requiring that a class be immutable.                                                                          |
| [RangeValueIterator](https://developer.android.com/reference/android/icu/util/RangeValueIterator) | Interface for enabling iteration over sets of \<int index, int value\>, where index is the sorted integer index in ascending order and value, its associated integer value. |
| [ValueIterator](https://developer.android.com/reference/android/icu/util/ValueIterator)           | Interface for enabling iteration over sets of \<int, Object\>, where int is the sorted integer index in ascending order, and Object its associated value.                   |

## Classes

|-----------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [BuddhistCalendar](https://developer.android.com/reference/android/icu/util/BuddhistCalendar)                         | `BuddhistCalendar`is a subclass of`GregorianCalendar`that numbers years since the birth of the Buddha.                                                                                                                     |
| [Calendar](https://developer.android.com/reference/android/icu/util/Calendar)                                         | **\[icu enhancement\]** ICU's replacement for[Calendar](https://developer.android.com/reference/java/util/Calendar). Methods, fields, and other functionality specific to ICU are labeled '**\[icu\]**'.                   |
| [Calendar.WeekData](https://developer.android.com/reference/android/icu/util/Calendar.WeekData)                       | Simple, immutable struct-like class for access to the CLDR week data.                                                                                                                                                      |
| [ChineseCalendar](https://developer.android.com/reference/android/icu/util/ChineseCalendar)                           | `ChineseCalendar`is a concrete subclass of[Calendar](https://developer.android.com/reference/android/icu/util/Calendar)that implements a traditional Chinese calendar.                                                     |
| [CopticCalendar](https://developer.android.com/reference/android/icu/util/CopticCalendar)                             | Implement the Coptic calendar system.                                                                                                                                                                                      |
| [Currency](https://developer.android.com/reference/android/icu/util/Currency)                                         | A class encapsulating a currency, as defined by ISO 4217.                                                                                                                                                                  |
| [CurrencyAmount](https://developer.android.com/reference/android/icu/util/CurrencyAmount)                             | An amount of currency, consisting of a Number and a Currency.                                                                                                                                                              |
| [DateInterval](https://developer.android.com/reference/android/icu/util/DateInterval)                                 | This class represents date interval.                                                                                                                                                                                       |
| [EthiopicCalendar](https://developer.android.com/reference/android/icu/util/EthiopicCalendar)                         | Implement the Ethiopic calendar system.                                                                                                                                                                                    |
| [GregorianCalendar](https://developer.android.com/reference/android/icu/util/GregorianCalendar)                       | **\[icu enhancement\]** ICU's replacement for[GregorianCalendar](https://developer.android.com/reference/java/util/GregorianCalendar). Methods, fields, and other functionality specific to ICU are labeled '**\[icu\]**'. |
| [HebrewCalendar](https://developer.android.com/reference/android/icu/util/HebrewCalendar)                             | `HebrewCalendar`is a subclass of`Calendar`that that implements the traditional Hebrew calendar.                                                                                                                            |
| [IndianCalendar](https://developer.android.com/reference/android/icu/util/IndianCalendar)                             | `IndianCalendar`is a subclass of`GregorianCalendar`that numbers years since the birth of the Buddha.                                                                                                                       |
| [IslamicCalendar](https://developer.android.com/reference/android/icu/util/IslamicCalendar)                           | `IslamicCalendar`is a subclass of`Calendar`that that implements the Islamic civil and religious calendars.                                                                                                                 |
| [JapaneseCalendar](https://developer.android.com/reference/android/icu/util/JapaneseCalendar)                         | `JapaneseCalendar`is a subclass of`GregorianCalendar`that numbers years and eras based on the reigns of the Japanese emperors.                                                                                             |
| [LocaleData](https://developer.android.com/reference/android/icu/util/LocaleData)                                     | A class for accessing miscellaneous data in the locale bundles                                                                                                                                                             |
| [LocaleData.MeasurementSystem](https://developer.android.com/reference/android/icu/util/LocaleData.MeasurementSystem) | Enumeration for representing the measurement systems.                                                                                                                                                                      |
| [LocaleData.PaperSize](https://developer.android.com/reference/android/icu/util/LocaleData.PaperSize)                 | A class that represents the size of letter head used in the country                                                                                                                                                        |
| [Measure](https://developer.android.com/reference/android/icu/util/Measure)                                           | An amount of a specified unit, consisting of a Number and a Unit.                                                                                                                                                          |
| [MeasureUnit](https://developer.android.com/reference/android/icu/util/MeasureUnit)                                   | A unit such as length, mass, volume, currency, etc.                                                                                                                                                                        |
| [Output](https://developer.android.com/reference/android/icu/util/Output)\<T\>                                        | Simple struct-like class for output parameters.                                                                                                                                                                            |
| [RangeValueIterator.Element](https://developer.android.com/reference/android/icu/util/RangeValueIterator.Element)     | Return result wrapper for android.icu.util.RangeValueIterator.                                                                                                                                                             |
| [TaiwanCalendar](https://developer.android.com/reference/android/icu/util/TaiwanCalendar)                             | `TaiwanCalendar`is a subclass of`GregorianCalendar`that numbers years since 1912.                                                                                                                                          |
| [TimeUnit](https://developer.android.com/reference/android/icu/util/TimeUnit)                                         | Measurement unit for time units.                                                                                                                                                                                           |
| [TimeZone](https://developer.android.com/reference/android/icu/util/TimeZone)                                         | **\[icu enhancement\]** ICU's replacement for[TimeZone](https://developer.android.com/reference/java/util/TimeZone). Methods, fields, and other functionality specific to ICU are labeled '**\[icu\]**'.                   |
| [ULocale](https://developer.android.com/reference/android/icu/util/ULocale)                                           | **\[icu enhancement\]** ICU's replacement for[Locale](https://developer.android.com/reference/java/util/Locale). Methods, fields, and other functionality specific to ICU are labeled '**\[icu\]**'.                       |
| [ULocale.Builder](https://developer.android.com/reference/android/icu/util/ULocale.Builder)                           | `Builder`is used to build instances of`ULocale`from values configured by the setters.                                                                                                                                      |
| [UniversalTimeScale](https://developer.android.com/reference/android/icu/util/UniversalTimeScale)                     | There are quite a few different conventions for binary datetime, depending on different platforms and protocols.                                                                                                           |
| [ValueIterator.Element](https://developer.android.com/reference/android/icu/util/ValueIterator.Element)               | The return result container of each iteration.                                                                                                                                                                             |
| [VersionInfo](https://developer.android.com/reference/android/icu/util/VersionInfo)                                   | Class to store version numbers of the form major.minor.milli.micro.                                                                                                                                                        |

## Enums

|-----------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Currency.CurrencyUsage](https://developer.android.com/reference/android/icu/util/Currency.CurrencyUsage)                   | Currency Usage used for Decimal Format                                                                                                                                                                                                                                                                          |
| [IslamicCalendar.CalculationType](https://developer.android.com/reference/android/icu/util/IslamicCalendar.CalculationType) | enumeration of available calendar calculation types                                                                                                                                                                                                                                                             |
| [MeasureUnit.Complexity](https://developer.android.com/reference/android/icu/util/MeasureUnit.Complexity)                   | Enumeration for unit complexity.                                                                                                                                                                                                                                                                                |
| [MeasureUnit.MeasurePrefix](https://developer.android.com/reference/android/icu/util/MeasureUnit.MeasurePrefix)             | Enumeration for SI and binary prefixes, e.g. "kilo-", "nano-", "mebi-".                                                                                                                                                                                                                                         |
| [TimeZone.SystemTimeZoneType](https://developer.android.com/reference/android/icu/util/TimeZone.SystemTimeZoneType)         | **\[icu\]** System time zone type constants used by filtering zones in[TimeZone.getAvailableIDs(SystemTimeZoneType, String, Integer)](https://developer.android.com/reference/android/icu/util/TimeZone#getAvailableIDs(android.icu.util.TimeZone.SystemTimeZoneType,%20java.lang.String,%20java.lang.Integer)) |
| [ULocale.AvailableType](https://developer.android.com/reference/android/icu/util/ULocale.AvailableType)                     | Types for[ULocale.getAvailableLocalesByType](https://developer.android.com/reference/android/icu/util/ULocale#getAvailableLocalesByType(android.icu.util.ULocale.AvailableType))                                                                                                                                |
| [ULocale.Category](https://developer.android.com/reference/android/icu/util/ULocale.Category)                               | Enum for locale categories.                                                                                                                                                                                                                                                                                     |

## Exceptions

|---------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [ICUUncheckedIOException](https://developer.android.com/reference/android/icu/util/ICUUncheckedIOException)   | Unchecked version of[IOException](https://developer.android.com/reference/java/io/IOException).                                                                                                                                                            |
| [IllformedLocaleException](https://developer.android.com/reference/android/icu/util/IllformedLocaleException) | Thrown by methods in[ULocale](https://developer.android.com/reference/android/icu/util/ULocale)and[ULocale.Builder](https://developer.android.com/reference/android/icu/util/ULocale.Builder)to indicate that an argument is not a well-formed BCP 47 tag. |

-

  ## Interfaces

  - [Freezable](https://developer.android.com/reference/android/icu/util/Freezable)
  - [RangeValueIterator](https://developer.android.com/reference/android/icu/util/RangeValueIterator)
  - [ValueIterator](https://developer.android.com/reference/android/icu/util/ValueIterator)
-

  ## Classes

  - [BuddhistCalendar](https://developer.android.com/reference/android/icu/util/BuddhistCalendar)
  - [Calendar](https://developer.android.com/reference/android/icu/util/Calendar)
  - [Calendar.WeekData](https://developer.android.com/reference/android/icu/util/Calendar.WeekData)
  - [ChineseCalendar](https://developer.android.com/reference/android/icu/util/ChineseCalendar)
  - [CopticCalendar](https://developer.android.com/reference/android/icu/util/CopticCalendar)
  - [Currency](https://developer.android.com/reference/android/icu/util/Currency)
  - [CurrencyAmount](https://developer.android.com/reference/android/icu/util/CurrencyAmount)
  - [DateInterval](https://developer.android.com/reference/android/icu/util/DateInterval)
  - [EthiopicCalendar](https://developer.android.com/reference/android/icu/util/EthiopicCalendar)
  - [GregorianCalendar](https://developer.android.com/reference/android/icu/util/GregorianCalendar)
  - [HebrewCalendar](https://developer.android.com/reference/android/icu/util/HebrewCalendar)
  - [IndianCalendar](https://developer.android.com/reference/android/icu/util/IndianCalendar)
  - [IslamicCalendar](https://developer.android.com/reference/android/icu/util/IslamicCalendar)
  - [JapaneseCalendar](https://developer.android.com/reference/android/icu/util/JapaneseCalendar)
  - [LocaleData](https://developer.android.com/reference/android/icu/util/LocaleData)
  - [LocaleData.MeasurementSystem](https://developer.android.com/reference/android/icu/util/LocaleData.MeasurementSystem)
  - [LocaleData.PaperSize](https://developer.android.com/reference/android/icu/util/LocaleData.PaperSize)
  - [Measure](https://developer.android.com/reference/android/icu/util/Measure)
  - [MeasureUnit](https://developer.android.com/reference/android/icu/util/MeasureUnit)
  - [Output](https://developer.android.com/reference/android/icu/util/Output)
  - [RangeValueIterator.Element](https://developer.android.com/reference/android/icu/util/RangeValueIterator.Element)
  - [TaiwanCalendar](https://developer.android.com/reference/android/icu/util/TaiwanCalendar)
  - [TimeUnit](https://developer.android.com/reference/android/icu/util/TimeUnit)
  - [TimeZone](https://developer.android.com/reference/android/icu/util/TimeZone)
  - [ULocale](https://developer.android.com/reference/android/icu/util/ULocale)
  - [ULocale.Builder](https://developer.android.com/reference/android/icu/util/ULocale.Builder)
  - [UniversalTimeScale](https://developer.android.com/reference/android/icu/util/UniversalTimeScale)
  - [ValueIterator.Element](https://developer.android.com/reference/android/icu/util/ValueIterator.Element)
  - [VersionInfo](https://developer.android.com/reference/android/icu/util/VersionInfo)
-

  ## Enums

  - [Currency.CurrencyUsage](https://developer.android.com/reference/android/icu/util/Currency.CurrencyUsage)
  - [IslamicCalendar.CalculationType](https://developer.android.com/reference/android/icu/util/IslamicCalendar.CalculationType)
  - [MeasureUnit.Complexity](https://developer.android.com/reference/android/icu/util/MeasureUnit.Complexity)
  - [MeasureUnit.MeasurePrefix](https://developer.android.com/reference/android/icu/util/MeasureUnit.MeasurePrefix)
  - [TimeZone.SystemTimeZoneType](https://developer.android.com/reference/android/icu/util/TimeZone.SystemTimeZoneType)
  - [ULocale.AvailableType](https://developer.android.com/reference/android/icu/util/ULocale.AvailableType)
  - [ULocale.Category](https://developer.android.com/reference/android/icu/util/ULocale.Category)
-

  ## Exceptions

  - [ICUUncheckedIOException](https://developer.android.com/reference/android/icu/util/ICUUncheckedIOException)
  - [IllformedLocaleException](https://developer.android.com/reference/android/icu/util/IllformedLocaleException)