SPI method to refresh the rules from the underlying data provider.
SPI method to refresh the rules from the underlying data provider.
This method provides the opportunity for a provider to dynamically recheck the underlying data provider to find the latest rules. This could be used to load new rules without stopping the JVM. Dynamic behavior is entirely optional and most providers do not support it.
This implementation returns false.
true if the rules were updated
if an error occurs during the refresh
SPI method to get the rules for the zone ID.
SPI method to get the rules for the zone ID.
This loads the rules for the region and version specified. The version may be null to indicate the "latest" version.
the rules, not null
if rules cannot be obtained
SPI method to get the history of rules for the zone ID.
SPI method to get the history of rules for the zone ID.
This returns a map of historical rules keyed by a version string. The exact meaning and format of the version is provider specific. The version must follow lexicographical order, thus the returned map will be order from the oldest known rules to the newest available rules. The default 'TZDB' group uses version numbering consisting of the year followed by a letter, such as '2009e' or '2012f'.
Implementations must provide a result for each valid zone ID, however they do not have to provide a history of rules. Thus the map will always contain one element, and will only contain more than one element if historical rule information is available.
The returned versions remain available and valid for the lifetime of the application. A dynamic provider may increase the set of versions as more data becomes available.
the zone region ID as used by { @code ZoneId}, not null
a modifiable copy of the history of the rules for the ID, sorted from oldest to newest, not null
if history cannot be obtained for the zone ID
SPI method to get the available zone IDs.
SPI method to get the available zone IDs.
This obtains the IDs that this ZoneRulesProvider provides.
A provider should provide data for at least one region.
The returned regions remain available and valid for the lifetime of the application. A dynamic provider may increase the set of regions as more data becomes available.
the unmodifiable set of region IDs being provided, not null
if a problem occurs while providing the IDs
Loads time-zone rules for 'TZDB'.
This class is public for the service loader to access.
Specification for implementors
This class is immutable and thread-safe.
if unable to load