Package dev.gmitch215.bytebox.time

Class ZoneHistory

java.lang.Object

dev.gmitch215.bytebox.time.ZoneHistory

public final class ZoneHistory
extends Object

A zone's recorded history, read from the timezone database ThreeTen-Backport carries.

Off unless a project asks for it. The platform's own database answers every question about an offset, and IntlZoneRules derives the rest from that, but it cannot list the changes a zone has had or the rules by which they recur, so those refuse. Calling register() installs this as their answer, and the generated entry point does that when the build sets classlib { zoneHistory = true }. A program that never names this class never links it, and the 108 KB database is only copied into the module when it is linked: see ZoneResources.

The file is read here rather than through ThreeTen's own reader, because that reader builds the rules class this package replaces. What is built instead is plain transitions and rules through their public factories, which is all ZoneRules.getTransitions() and getTransitionRules() return.

Only these two answers come from the bundle. Offsets, daylight saving and the search for the next change stay with the platform, so a platform whose database is newer than the bundle can disagree with the history it is shown.

Since:

1.0.3

Method Summary

Modifier and Type	Method	Description
boolean	covers(String zoneId)
ZoneOffsetTransition	next(String zoneId, Instant instant)
ZoneOffsetTransition	previous(String zoneId, Instant instant)
static void	register()	Makes the recorded history of a zone available, which is what the generated entry point calls.
List<ZoneOffsetTransitionRule>	rules(String zoneId)
List<ZoneOffsetTransition>	transitions(String zoneId)

Methods inherited from class java.lang.Object

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

Method Details

register

public static void register()

Makes the recorded history of a zone available, which is what the generated entry point calls.

transitions

public List<ZoneOffsetTransition> transitions(String zoneId)

rules

public List<ZoneOffsetTransitionRule> rules(String zoneId)

covers

public boolean covers(String zoneId)

next

public ZoneOffsetTransition next(String zoneId,
 Instant instant)

previous

public ZoneOffsetTransition previous(String zoneId,
 Instant instant)