Class CurrencyMetaInfo.CurrencyFilter

  • Enclosing class:
    CurrencyMetaInfo

    public static final class CurrencyMetaInfo.CurrencyFilter
    extends Object
    A filter used to select which currency info is returned.
    • Field Detail

      • region

        public final String region
        The region to filter on. If null, accepts any region.
      • currency

        public final String currency
        The currency to filter on. If null, accepts any currency.
      • from

        public final long from
        The from date to filter on (as milliseconds). Accepts any currency on or after this date.
      • to

        public final long to
        The to date to filter on (as milliseconds). Accepts any currency on or before this date.
      • tenderOnly

        @Deprecated
        public final boolean tenderOnly
        Deprecated.
        This API is ICU internal only.
        true if we are filtering only for currencies used as legal tender.
    • Method Detail

      • onDateRange

        public static CurrencyMetaInfo.CurrencyFilter onDateRange​(Date from,
                                                                  Date to)
        Returns a filter that accepts all currencies that were in use at some point between the given dates, or if dates are equal, currencies in use on that date.
        Parameters:
        from - date on or after a currency must have been in use
        to - date on or before which a currency must have been in use, or if equal to from, the date on which a currency must have been in use
        Returns:
        a filter
        See Also:
        withDateRange(Date, Date)
      • onDate

        public static CurrencyMetaInfo.CurrencyFilter onDate​(long date)
        Returns a filter that accepts all currencies in use on the given date.
        Parameters:
        date - the date as milliseconds after Jan 1, 1970
      • onDateRange

        public static CurrencyMetaInfo.CurrencyFilter onDateRange​(long from,
                                                                  long to)
        Returns a filter that accepts all currencies that were in use at some point between the given dates, or if dates are equal, currencies in use on that date.
        Parameters:
        from - The date on or after a currency must have been in use. Measured in milliseconds since Jan 1, 1970 GMT.
        to - The date on or before which a currency must have been in use. Measured in milliseconds since Jan 1, 1970 GMT.
      • onTender

        public static CurrencyMetaInfo.CurrencyFilter onTender()
        Returns a CurrencyFilter for finding currencies that were either once used, are used, or will be used as tender.
      • withRegion

        public CurrencyMetaInfo.CurrencyFilter withRegion​(String region)
        Returns a copy of this filter, with the specified region. Region can be null to indicate no filter on region.
        Parameters:
        region - the region code
        Returns:
        the filter
        See Also:
        onRegion(String)
      • withCurrency

        public CurrencyMetaInfo.CurrencyFilter withCurrency​(String currency)
        Returns a copy of this filter, with the specified currency. Currency can be null to indicate no filter on currency.
        Parameters:
        currency - the currency code
        Returns:
        the filter
        See Also:
        onCurrency(String)
      • withDate

        public CurrencyMetaInfo.CurrencyFilter withDate​(Date date)
        Returns a copy of this filter, with from and to set to the given date.
        Parameters:
        date - the date on which the currency must have been in use
        Returns:
        the filter
        See Also:
        onDate(Date)
      • withDateRange

        public CurrencyMetaInfo.CurrencyFilter withDateRange​(Date from,
                                                             Date to)
        Returns a copy of this filter, with from and to set to the given dates.
        Parameters:
        from - date on or after which the currency must have been in use
        to - date on or before which the currency must have been in use
        Returns:
        the filter
        See Also:
        onDateRange(Date, Date)
      • withDate

        public CurrencyMetaInfo.CurrencyFilter withDate​(long date)
        Returns a copy of this filter that accepts all currencies in use on the given date.
        Parameters:
        date - the date as milliseconds after Jan 1, 1970
      • withDateRange

        public CurrencyMetaInfo.CurrencyFilter withDateRange​(long from,
                                                             long to)
        Returns a copy of this filter that accepts all currencies that were in use at some point between the given dates, or if dates are equal, currencies in use on that date.
        Parameters:
        from - The date on or after a currency must have been in use. Measured in milliseconds since Jan 1, 1970 GMT.
        to - The date on or before which a currency must have been in use. Measured in milliseconds since Jan 1, 1970 GMT.
      • withTender

        public CurrencyMetaInfo.CurrencyFilter withTender()
        Returns a copy of this filter that filters for currencies that were either once used, are used, or will be used as tender.
      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class Object
      • toString

        public String toString()
        Returns a string representing the filter, for debugging.
        Overrides:
        toString in class Object
        Returns:
        A string representing the filter.