Class CurrencyMetaInfo


  • public class CurrencyMetaInfo
    extends java.lang.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.
    • Constructor Detail

      • CurrencyMetaInfo

        @Deprecated
        protected CurrencyMetaInfo()
        Deprecated.
        This API is ICU internal only.
        Subclass constructor.
    • Method Detail

      • getInstance

        public static CurrencyMetaInfo getInstance()
        Returns the unique instance of the currency meta info.
        Returns:
        the meta info
      • 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
      • hasData

        @Deprecated
        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
      • currencyInfo

        public java.util.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
      • currencies

        public java.util.List<java.lang.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
      • regions

        public java.util.List<java.lang.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
      • currencyDigits

        public CurrencyMetaInfo.CurrencyDigits currencyDigits​(java.lang.String isoCode)
        Returns the CurrencyDigits for the currency code. This is equivalent to currencyDigits(isoCode, CurrencyUsage.STANDARD);
        Parameters:
        isoCode - the currency code
        Returns:
        the CurrencyDigits
      • currencyDigits

        public CurrencyMetaInfo.CurrencyDigits currencyDigits​(java.lang.String isoCode,
                                                              Currency.CurrencyUsage currencyUsage)
        Returns the CurrencyDigits for the currency code with Context Usage.
        Parameters:
        isoCode - the currency code
        currencyUsage - the currency usage
        Returns:
        the CurrencyDigits