Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	ZoneMeta.CustomTimeZoneCache Custom time zone object cache
private static class	ZoneMeta.SystemTimeZoneCache System time zone object cache

Field Summary

Modifier and Type	Field and Description
private static final boolean	ASSERT
private static ICUCache<String, String>	CANONICAL_ID_CACHE
private static final ZoneMeta.CustomTimeZoneCache	CUSTOM_ZONE_CACHE
private static final String	kCUSTOM_TZ_PREFIX
private static final String	kGMT_ID
private static final int	kMAX_CUSTOM_HOUR
private static final int	kMAX_CUSTOM_MIN
private static final int	kMAX_CUSTOM_SEC
private static final String	kNAMES
private static final String	kREGIONS
private static final String	kWorld
private static final String	kZONES
private static SoftReference<Set<String>>	REF_CANONICAL_SYSTEM_LOCATION_ZONES
private static SoftReference<Set<String>>	REF_CANONICAL_SYSTEM_ZONES
private static SoftReference<Set<String>>	REF_SYSTEM_ZONES
private static ICUCache<String, String>	REGION_CACHE
private static ICUCache<String, Boolean>	SINGLE_COUNTRY_CACHE
private static final ZoneMeta.SystemTimeZoneCache	SYSTEM_ZONE_CACHE
private static String[]	ZONEIDS
private static final String	ZONEINFORESNAME

Constructor Summary

Access	Constructor and Description
public	ZoneMeta()

Method Summary

Modifier and Type	Method and Description
public static synchronized int	Returns: the number of zones in the equivalency group containing 'id', or zero if there are no equivalent zones. countEquivalentIDs(String a system time zone ID id) Returns the number of IDs in the equivalency group that includes the given ID. An equivalency group contains zones that behave identically to the given zone.
private static String	findCLDRCanonicalID(String tzid)
pack-priv static String	formatCustomID(int hour, int min, int sec, boolean negative)
public static Set<String>	Returns: An immutable set of system IDs for the given conditions. getAvailableIDs(TimeZone.SystemTimeZoneType a system time zone type. type, String a region, or null. region, Integer a zone raw offset or null. rawOffset) Returns an immutable set of system IDs for the given conditions.
public static String	getCanonicalCLDRID(TimeZone tz)
public static String	getCanonicalCLDRID(String tzid) Return the canonical id for this tzid defined by CLDR, which might be the id itself.
public static String	getCanonicalCountry(String tzid) Return the canonical country code for this tzid.
public static String	getCanonicalCountry(String tzid, Output<Boolean> isPrimary) Return the canonical country code for this tzid.
private static synchronized Set<String>	Returns: An immutable set of canonical system time zone IDs that are associated with actual locations. getCanonicalSystemLocationZIDs() Returns an immutable set of canonical system time zone IDs that are associated with actual locations.
private static synchronized Set<String>	Returns: An immutable set of canonical system time zone IDs. getCanonicalSystemZIDs() Returns an immutable set of canonical system time zone IDs.
public static String	Returns: The normalized custom id string. getCustomID(String a string of the form GMT[+-]hh:mm, GMT[+-]hhmm, or GMT[+-]hh. id) Parse a custom time zone identifier and return the normalized custom time zone identifier for the given custom id string.
public static SimpleTimeZone	Returns: a frozen SimpleTimeZone with the given offset and no Daylight Savings Time, or null if the id cannot be parsed. getCustomTimeZone(String a string of the form GMT[+-]hh:mm, GMT[+-]hhmm, or GMT[+-]hh. id) Parse a custom time zone identifier and return a corresponding zone.
public static SimpleTimeZone	Returns: A custom TimeZone for the offset with normalized time zone id getCustomTimeZone(int GMT offset in milliseconds offset) Creates a custom zone for the offset
public static synchronized String	Returns: the ID of the index-th zone in the equivalency group containing 'id', or an empty string if 'id' is not a valid system ID or 'index' is out of range getEquivalentID(String a system time zone ID id, int a value from 0 to n-1, where n is the value returned by `countEquivalentIDs(id)` index) Returns an ID in the equivalency group that includes the given ID. An equivalency group contains zones that behave identically to the given zone.
public static String	Returns: A primary IANA zone ID equivalent to the input zone ID. getIanaID(String An input zone ID. tzid) Returns primary IANA zone ID for the input zone ID. When input zone ID is not known, this method returns null.
public static String	getRegion(String tzid) Return the region code for this tzid.
public static String	Returns: the short ID of the time zone, or null if the short ID is not available. getShortID(TimeZone the time zone tz) Returns the time zone's short ID for the zone.
public static String	Returns: the short ID of the time zone ID, or null if the short ID is not available. getShortID(String the time zone ID id) Returns the time zone's short ID for the zone ID. For example, "uslax" for zone ID "America/Los_Angeles".
private static String	getShortIDFromCanonical(String canonicalID)
public static OlsonTimeZone	getSystemTimeZone(String id) Returns a frozen OlsonTimeZone instance for the given ID. This method returns null when the given ID is unknown.
private static synchronized Set<String>	Returns: An immutable set of system time zone IDs. getSystemZIDs() Returns an immutable set of system time zone IDs.
private static String	getZoneID(int idx)
private static synchronized String[]	getZoneIDs()
private static int	getZoneIndex(String zid)
public static UResourceBundle	Returns: the corresponding zone resource or null if not found openOlsonResource(UResourceBundle the top level resource of the zoneinfo resource or null. top, String zone id id) Given an ID and the top-level resource of the zoneinfo resource, open the appropriate resource for the given time zone.
pack-priv static boolean	parseCustomID(String id, int[] fields)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

ASSERT	back to summary
private static final boolean ASSERT

CANONICAL_ID_CACHE	back to summary
private static ICUCache<String, String> CANONICAL_ID_CACHE

CUSTOM_ZONE_CACHE	back to summary
private static final ZoneMeta.CustomTimeZoneCache CUSTOM_ZONE_CACHE

kCUSTOM_TZ_PREFIX	back to summary
private static final String kCUSTOM_TZ_PREFIX

kGMT_ID	back to summary
private static final String kGMT_ID

kMAX_CUSTOM_HOUR	back to summary
private static final int kMAX_CUSTOM_HOUR

kMAX_CUSTOM_MIN	back to summary
private static final int kMAX_CUSTOM_MIN

kMAX_CUSTOM_SEC	back to summary
private static final int kMAX_CUSTOM_SEC

kNAMES	back to summary
private static final String kNAMES

kREGIONS	back to summary
private static final String kREGIONS

kWorld	back to summary
private static final String kWorld

kZONES	back to summary
private static final String kZONES

REF_CANONICAL_SYSTEM_LOCATION_ZONES	back to summary
private static SoftReference<Set<String>> REF_CANONICAL_SYSTEM_LOCATION_ZONES

REF_CANONICAL_SYSTEM_ZONES	back to summary
private static SoftReference<Set<String>> REF_CANONICAL_SYSTEM_ZONES

REF_SYSTEM_ZONES	back to summary
private static SoftReference<Set<String>> REF_SYSTEM_ZONES

REGION_CACHE	back to summary
private static ICUCache<String, String> REGION_CACHE

SINGLE_COUNTRY_CACHE	back to summary
private static ICUCache<String, Boolean> SINGLE_COUNTRY_CACHE

SYSTEM_ZONE_CACHE	back to summary
private static final ZoneMeta.SystemTimeZoneCache SYSTEM_ZONE_CACHE

ZONEIDS	back to summary
private static String[] ZONEIDS

ZONEINFORESNAME	back to summary
private static final String ZONEINFORESNAME

Constructor Detail

ZoneMeta	back to summary
public ZoneMeta()

Method Detail

countEquivalentIDs back to summary

countEquivalentIDs	back to summary
public static synchronized int countEquivalentIDs(String id) Returns the number of IDs in the equivalency group that includes the given ID. An equivalency group contains zones that behave identically to the given zone. If there are no equivalent zones, then this method returns 0. This means either the given ID is not a valid zone, or it is and there are no other equivalent zones. Parameters id:String a system time zone ID Returns:int the number of zones in the equivalency group containing 'id', or zero if there are no equivalent zones. See Also `getEquivalentID`

public static synchronized int countEquivalentIDs(String id)

Returns the number of IDs in the equivalency group that includes the given ID. An equivalency group contains zones that behave identically to the given zone.

If there are no equivalent zones, then this method returns 0. This means either the given ID is not a valid zone, or it is and there are no other equivalent zones.

Parameters

id:String: a system time zone ID

Returns:int

the number of zones in the equivalency group containing 'id', or zero if there are no equivalent zones.

See Also

getEquivalentID

findCLDRCanonicalID	back to summary
private static String findCLDRCanonicalID(String tzid)

formatCustomID	back to summary
pack-priv static String formatCustomID(int hour, int min, int sec, boolean negative)

getAvailableIDs	back to summary
public static Set<String> getAvailableIDs(TimeZone.SystemTimeZoneType type, String region, Integer rawOffset) Returns an immutable set of system IDs for the given conditions. Parameters type:TimeZone.SystemTimeZoneType a system time zone type. region:String a region, or null. rawOffset:Integer a zone raw offset or null. Returns:Set<String> An immutable set of system IDs for the given conditions.

getAvailableIDs

back to summary

public static Set<String> getAvailableIDs(TimeZone.SystemTimeZoneType type, String region, Integer rawOffset)

Returns an immutable set of system IDs for the given conditions.

Parameters

type:TimeZone.SystemTimeZoneType: a system time zone type.
region:String: a region, or null.
rawOffset:Integer: a zone raw offset or null.

Returns:Set<String>

An immutable set of system IDs for the given conditions.

getCanonicalCLDRID	back to summary
public static String getCanonicalCLDRID(TimeZone tz)

getCanonicalCLDRID	back to summary
public static String getCanonicalCLDRID(String tzid) Return the canonical id for this tzid defined by CLDR, which might be the id itself. If the given tzid is not known, return null. Note This internal API supports all known system IDs and "Etc/Unknown" (which is NOT a system ID).

getCanonicalCountry	back to summary
public static String getCanonicalCountry(String tzid) Return the canonical country code for this tzid. If we have none, or if the time zone is not associated with a country or unknown, return null.

getCanonicalCountry	back to summary
public static String getCanonicalCountry(String tzid, Output<Boolean> isPrimary) Return the canonical country code for this tzid. If we have none, or if the time zone is not associated with a country or unknown, return null. When the given zone is the primary zone of the country, true is set to isPrimary.

getCanonicalSystemLocationZIDs back to summary

getCanonicalSystemLocationZIDs	back to summary
private static synchronized Set<String> getCanonicalSystemLocationZIDs() Returns an immutable set of canonical system time zone IDs that are associated with actual locations. The result set is a subset of `getCanonicalSystemZIDs()`, but not including IDs, such as "Etc/GTM+5". Returns:Set<String> An immutable set of canonical system time zone IDs that are associated with actual locations.

private static synchronized Set<String> getCanonicalSystemLocationZIDs()

Returns an immutable set of canonical system time zone IDs that are associated with actual locations. The result set is a subset of getCanonicalSystemZIDs(), but not including IDs, such as "Etc/GTM+5".

Returns:Set<String>: An immutable set of canonical system time zone IDs that are associated with actual locations.

getCanonicalSystemZIDs back to summary

getCanonicalSystemZIDs	back to summary
private static synchronized Set<String> getCanonicalSystemZIDs() Returns an immutable set of canonical system time zone IDs. The result set is a subset of `getSystemZIDs()`, but not including aliases, such as "US/Eastern". Returns:Set<String> An immutable set of canonical system time zone IDs.

private static synchronized Set<String> getCanonicalSystemZIDs()

Returns an immutable set of canonical system time zone IDs. The result set is a subset of getSystemZIDs(), but not including aliases, such as "US/Eastern".

Returns:Set<String>: An immutable set of canonical system time zone IDs.

getCustomID	back to summary
public static String getCustomID(String id) Parse a custom time zone identifier and return the normalized custom time zone identifier for the given custom id string. Parameters id:String a string of the form GMT[+-]hh:mm, GMT[+-]hhmm, or GMT[+-]hh. Returns:String The normalized custom id string.

getCustomID

back to summary

public static String getCustomID(String id)

Parse a custom time zone identifier and return the normalized custom time zone identifier for the given custom id string.

Parameters

id:String: a string of the form GMT[+-]hh:mm, GMT[+-]hhmm, or GMT[+-]hh.

Returns:String

The normalized custom id string.

getCustomTimeZone	back to summary
public static SimpleTimeZone getCustomTimeZone(String id) Parse a custom time zone identifier and return a corresponding zone. Parameters id:String a string of the form GMT[+-]hh:mm, GMT[+-]hhmm, or GMT[+-]hh. Returns:SimpleTimeZone a frozen SimpleTimeZone with the given offset and no Daylight Savings Time, or null if the id cannot be parsed.

getCustomTimeZone

back to summary

public static SimpleTimeZone getCustomTimeZone(String id)

Parse a custom time zone identifier and return a corresponding zone.

Parameters

id:String: a string of the form GMT[+-]hh:mm, GMT[+-]hhmm, or GMT[+-]hh.

Returns:SimpleTimeZone

a frozen SimpleTimeZone with the given offset and no Daylight Savings Time, or null if the id cannot be parsed.

getCustomTimeZone	back to summary
public static SimpleTimeZone getCustomTimeZone(int offset) Creates a custom zone for the offset Parameters offset:int GMT offset in milliseconds Returns:SimpleTimeZone A custom TimeZone for the offset with normalized time zone id

getCustomTimeZone

back to summary

public static SimpleTimeZone getCustomTimeZone(int offset)

Creates a custom zone for the offset

Parameters

offset:int: GMT offset in milliseconds

Returns:SimpleTimeZone

A custom TimeZone for the offset with normalized time zone id

getEquivalentID back to summary

getEquivalentID	back to summary
public static synchronized String getEquivalentID(String id, int index) Returns an ID in the equivalency group that includes the given ID. An equivalency group contains zones that behave identically to the given zone. The given index must be in the range 0..n-1, where n is the value returned by `countEquivalentIDs(id)`. For some value of 'index', the returned value will be equal to the given id. If the given id is not a valid system time zone, or if 'index' is out of range, then returns an empty string. Parameters id:String a system time zone ID index:int a value from 0 to n-1, where n is the value returned by `countEquivalentIDs(id)` Returns:String the ID of the index-th zone in the equivalency group containing 'id', or an empty string if 'id' is not a valid system ID or 'index' is out of range See Also `countEquivalentIDs`

public static synchronized String getEquivalentID(String id, int index)

Returns an ID in the equivalency group that includes the given ID. An equivalency group contains zones that behave identically to the given zone.

The given index must be in the range 0..n-1, where n is the value returned by countEquivalentIDs(id). For some value of 'index', the returned value will be equal to the given id. If the given id is not a valid system time zone, or if 'index' is out of range, then returns an empty string.

Parameters

id:String: a system time zone ID
index:int: a value from 0 to n-1, where n is the value returned by countEquivalentIDs(id)

Returns:String

the ID of the index-th zone in the equivalency group containing 'id', or an empty string if 'id' is not a valid system ID or 'index' is out of range

See Also

countEquivalentIDs

getIanaID	back to summary
public static String getIanaID(String tzid) Returns primary IANA zone ID for the input zone ID. When input zone ID is not known, this method returns null. Parameters tzid:String An input zone ID. Returns:String A primary IANA zone ID equivalent to the input zone ID.

getIanaID

back to summary

public static String getIanaID(String tzid)

Returns primary IANA zone ID for the input zone ID. When input zone ID is not known, this method returns null.

Parameters

tzid:String: An input zone ID.

Returns:String

A primary IANA zone ID equivalent to the input zone ID.

getRegion	back to summary
public static String getRegion(String tzid) Return the region code for this tzid. If tzid is not a system zone ID, this method returns null.

getShortID	back to summary
public static String getShortID(TimeZone tz) Returns the time zone's short ID for the zone. For example, "uslax" for zone "America/Los_Angeles". Parameters tz:TimeZone the time zone Returns:String the short ID of the time zone, or null if the short ID is not available.

getShortID

back to summary

public static String getShortID(TimeZone tz)

Returns the time zone's short ID for the zone. For example, "uslax" for zone "America/Los_Angeles".

Parameters

tz:TimeZone: the time zone

Returns:String

the short ID of the time zone, or null if the short ID is not available.

getShortID	back to summary
public static String getShortID(String id) Returns the time zone's short ID for the zone ID. For example, "uslax" for zone ID "America/Los_Angeles". Parameters id:String the time zone ID Returns:String the short ID of the time zone ID, or null if the short ID is not available.

getShortID

back to summary

public static String getShortID(String id)

Returns the time zone's short ID for the zone ID. For example, "uslax" for zone ID "America/Los_Angeles".

Parameters

id:String: the time zone ID

Returns:String

the short ID of the time zone ID, or null if the short ID is not available.

getShortIDFromCanonical	back to summary
private static String getShortIDFromCanonical(String canonicalID)

getSystemTimeZone	back to summary
public static OlsonTimeZone getSystemTimeZone(String id) Returns a frozen OlsonTimeZone instance for the given ID. This method returns null when the given ID is unknown.

getSystemZIDs	back to summary
private static synchronized Set<String> getSystemZIDs() Returns an immutable set of system time zone IDs. Etc/Unknown is excluded. Returns:Set<String> An immutable set of system time zone IDs.

getSystemZIDs

back to summary

private static synchronized Set<String> getSystemZIDs()

Returns an immutable set of system time zone IDs. Etc/Unknown is excluded.

Returns:Set<String>: An immutable set of system time zone IDs.

getZoneID	back to summary
private static String getZoneID(int idx)

getZoneIDs	back to summary
private static synchronized String[] getZoneIDs()

getZoneIndex	back to summary
private static int getZoneIndex(String zid)

openOlsonResource	back to summary
public static UResourceBundle openOlsonResource(UResourceBundle top, String id) Given an ID and the top-level resource of the zoneinfo resource, open the appropriate resource for the given time zone. Dereference links if necessary. Parameters top:UResourceBundle the top level resource of the zoneinfo resource or null. id:String zone id Returns:UResourceBundle the corresponding zone resource or null if not found

openOlsonResource

back to summary

public static UResourceBundle openOlsonResource(UResourceBundle top, String id)

Given an ID and the top-level resource of the zoneinfo resource, open the appropriate resource for the given time zone. Dereference links if necessary.

Parameters

top:UResourceBundle: the top level resource of the zoneinfo resource or null.
id:String: zone id

Returns:UResourceBundle

the corresponding zone resource or null if not found

parseCustomID	back to summary
pack-priv static boolean parseCustomID(String id, int[] fields)

com.ibm.icu.impl back to summary

private Class ZoneMeta.CustomTimeZoneCache

Class Inheritance

extends SoftCache<Integer, SimpleTimeZone, int[]>

java.lang.Object
com.ibm.icu.impl.CacheBase
com.ibm.icu.impl.SoftCache
com.ibm.icu.impl.ZoneMeta.CustomTimeZoneCache

Custom time zone object cache

Constructor Summary

Access	Constructor and Description
private	CustomTimeZoneCache()

Method Summary

Modifier and Type	Method and Description
protected SimpleTimeZone	createInstance(Integer Cache lookup key for the requested instance key, int[] Data for the instance creation data) Implements abstract com.ibm.icu.impl.CacheBase.createInstance. Creates an instance for the key and data.

Inherited from com.ibm.icu.impl.SoftCache:: getInstance

Constructor Detail

CustomTimeZoneCache	back to summary
private CustomTimeZoneCache()

Method Detail

createInstance

back to summary

protected SimpleTimeZone createInstance(Integer key, int[] data)

Implements abstract com.ibm.icu.impl.CacheBase.createInstance.

Doc from com.ibm.icu.impl.CacheBase.createInstance.

Creates an instance for the key and data. Must be overridden.

Parameters

key:Integer: Cache lookup key for the requested instance
data:int[]: Data for the instance creation

Returns:SimpleTimeZone

The requested instance

Annotations

@Override

com.ibm.icu.impl back to summary

private Class ZoneMeta.SystemTimeZoneCache

Class Inheritance

extends SoftCache<String, OlsonTimeZone, String>

java.lang.Object
com.ibm.icu.impl.CacheBase
com.ibm.icu.impl.SoftCache
com.ibm.icu.impl.ZoneMeta.SystemTimeZoneCache

System time zone object cache

Constructor Summary

Access	Constructor and Description
private	SystemTimeZoneCache()

Method Summary

Modifier and Type	Method and Description
protected OlsonTimeZone	createInstance(String Cache lookup key for the requested instance key, String Data for the instance creation data) Implements abstract com.ibm.icu.impl.CacheBase.createInstance. Creates an instance for the key and data.