com.ibm.icu.text
Class CurrencyMetaInfo

java.lang.Object
  com.ibm.icu.text.CurrencyMetaInfo

public class CurrencyMetaInfo
extends Object

Provides information about currencies that is not specific to a locale. A note about currency dates. The CLDR data provides data to the day, inclusive. The date information used by CurrencyInfo and CurrencyFilter is represented by milliseconds, which is overly precise. These times are in GMT, so queries involving dates should use GMT times, but more generally you should avoid relying on time of day in queries. This class is not intended for public subclassing.

Status:

Draft ICU 4.4.

Nested Class Summary

static class	CurrencyMetaInfo.CurrencyDigits Represents the raw information about fraction digits and rounding increment.
static class	CurrencyMetaInfo.CurrencyFilter A filter used to select which currency info is returned.
static class	CurrencyMetaInfo.CurrencyInfo Represents a complete currency info record listing the region, currency, from and to dates, and priority.

Field Summary

protected static CurrencyMetaInfo.CurrencyDigits

defaultDigits Deprecated. This API is ICU internal only.

Constructor Summary

protected

CurrencyMetaInfo() Deprecated. This API is ICU internal only.

Method Summary

List<String>	currencies(CurrencyMetaInfo.CurrencyFilter filter) Returns the list of currency codes matching the provided filter.
CurrencyMetaInfo.CurrencyDigits	currencyDigits(String isoCode) Returns the CurrencyDigits for the currency code.
List<CurrencyMetaInfo.CurrencyInfo>	currencyInfo(CurrencyMetaInfo.CurrencyFilter filter) Returns the list of CurrencyInfos matching the provided filter.
static CurrencyMetaInfo	getInstance() Returns the unique instance of the currency meta info.
static CurrencyMetaInfo	getInstance(boolean noSubstitute) Returns the unique instance of the currency meta info, or null if noSubstitute is true and there is no data to support this API.
static boolean	hasData() Deprecated. This API is ICU internal only.
List<String>	regions(CurrencyMetaInfo.CurrencyFilter filter) Returns the list of region codes matching the provided filter.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

defaultDigits

protected static final CurrencyMetaInfo.CurrencyDigits defaultDigits

Deprecated. This API is ICU internal only.

Status:

Internal. This API is ICU internal only.

Constructor Detail

CurrencyMetaInfo

protected CurrencyMetaInfo()

Deprecated. This API is ICU internal only.

Subclass constructor.

Status:

Internal. This API is ICU internal only.

Method Detail

getInstance

public static CurrencyMetaInfo getInstance()

Returns the unique instance of the currency meta info.

Returns:

the meta info

Status:

Draft ICU 4.4.

getInstance

public static CurrencyMetaInfo getInstance(boolean noSubstitute)

Returns the unique instance of the currency meta info, or null if noSubstitute is true and there is no data to support this API.

Parameters:

noSubstitute - true if no substitute data should be used

Returns:

the meta info, or null

Status:

Draft ICU 49.

hasData

public static boolean hasData()

Deprecated. This API is ICU internal only.

Returns true if there is data for the currency meta info.

Returns:

true if there is actual data

Status:

Internal. This API is ICU internal only.

currencyInfo

public List<CurrencyMetaInfo.CurrencyInfo> currencyInfo(CurrencyMetaInfo.CurrencyFilter filter)

Returns the list of CurrencyInfos matching the provided filter. Results are ordered by country code, then by highest to lowest priority (0 is highest). The returned list is unmodifiable.

Parameters:

filter - the filter to control which currency info to return

Returns:

the matching information

Status:

Draft ICU 4.4.

currencies

public List<String> currencies(CurrencyMetaInfo.CurrencyFilter filter)

Returns the list of currency codes matching the provided filter. Results are ordered as in currencyInfo(CurrencyFilter). The returned list is unmodifiable.

Parameters:

filter - the filter to control which currencies to return. If filter is null, returns all currencies for which information is available.

Returns:

the matching currency codes

Status:

Draft ICU 4.4.

regions

public List<String> regions(CurrencyMetaInfo.CurrencyFilter filter)

Returns the list of region codes matching the provided filter. Results are ordered as in currencyInfo(CurrencyFilter). The returned list is unmodifiable.

Parameters:

filter - the filter to control which regions to return. If filter is null, returns all regions for which information is available.

Returns:

the matching region codes

Status:

Draft ICU 4.4.

currencyDigits

public CurrencyMetaInfo.CurrencyDigits currencyDigits(String isoCode)

Returns the CurrencyDigits for the currency code.

Parameters:

isoCode - the currency code

Returns:

the CurrencyDigits

Status:

Draft ICU 4.4.