java.time.zone

Class TzdbZoneRulesProvider

java.lang.Object

java.time.zone.ZoneRulesProvider

java.time.zone.TzdbZoneRulesProvider

public final class TzdbZoneRulesProvider
extends ZoneRulesProvider

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.

Constructor Summary

Constructors

Constructor and Description
TzdbZoneRulesProvider() Creates an instance.

Method Summary

Methods

Modifier and Type	Method and Description
protected ZoneRules	provideRules(java.lang.String zoneId, boolean forCaching) SPI method to get the rules for the zone ID.
protected java.util.NavigableMap<java.lang.String,ZoneRules>	provideVersions(java.lang.String zoneId) SPI method to get the history of rules for the zone ID.
protected java.util.Set<java.lang.String>	provideZoneIds() SPI method to get the available zone IDs.
java.lang.String	toString()

Methods inherited from class java.time.zone.ZoneRulesProvider

getAvailableZoneIds, getRules, getVersions, provideRefresh, refresh, registerProvider

Methods inherited from class java.lang.Object

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

Constructor Detail

TzdbZoneRulesProvider

public TzdbZoneRulesProvider()

Creates an instance. Created by the ServiceLoader.

Throws:

ZoneRulesException - if unable to load

Method Detail

provideZoneIds

protected java.util.Set<java.lang.String> provideZoneIds()

Description copied from class: ZoneRulesProvider

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.

Specified by:

provideZoneIds in class ZoneRulesProvider

Returns:

the unmodifiable set of region IDs being provided, not null

provideRules

protected ZoneRules provideRules(java.lang.String zoneId,
                     boolean forCaching)

Description copied from class: ZoneRulesProvider

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.

Specified by:

provideRules in class ZoneRulesProvider

Parameters:

zoneId - the time-zone region ID, not null

Returns:

the rules, not null

provideVersions

protected java.util.NavigableMap<java.lang.String,ZoneRules> provideVersions(java.lang.String zoneId)

Description copied from class: ZoneRulesProvider

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.

Specified by:

provideVersions in class ZoneRulesProvider

Parameters:

zoneId - the zone region ID as used by ZoneId, not null

Returns:

a modifiable copy of the history of the rules for the ID, sorted from oldest to newest, not null

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object