added in API level 26

Support for time-zones and their rules.

Daylight Saving Time and Time-Zones are concepts used by Governments to alter local time. This package provides support for time-zones, their rules and the resulting gaps and overlaps in the local time-line typically caused by Daylight Saving Time.

Package specification

Unless otherwise noted, passing a null argument to a constructor or method in any class or interface in this package will cause a NullPointerException to be thrown. The Javadoc "@param" definition is used to summarise the null-behavior. The "@throws NullPointerException" is not explicitly documented in each method.

All calculations should check for numeric overflow and throw either an ArithmeticException or a DateTimeException.


ZoneOffsetTransition A transition between two offsets caused by a discontinuity in the local time-line. 
ZoneOffsetTransitionRule A rule expressing how to create a transition. 
ZoneRules The rules defining how the zone offset varies for a single time-zone. 


ZoneOffsetTransitionRule.TimeDefinition A definition of the way a local time can be converted to the actual transition date-time. 


ZoneRulesException Thrown to indicate a problem with time-zone configuration.