Skip to content

Most visited

Recently visited


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. 
This site uses cookies to store your preferences for site-specific language and display options.


This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.