AI-generated Key Takeaways
-
This package supports time-zones, including Daylight Saving Time rules and resulting time-line gaps/overlaps.
-
It provides classes for managing time-zone rules, transitions, and offsets, using ICU4J TimeZones for rule generation.
-
Null arguments passed to constructors or methods will result in a NullPointerException.
-
Calculations check for numeric overflow, throwing ArithmeticException or DateTimeException.
-
ZoneRulesException is thrown to indicate time-zone configuration issues.
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.
Classes
| IcuZoneRulesProvider | A ZoneRulesProvider that generates rules from ICU4J TimeZones. |
| 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. |
| ZoneRulesProvider | Provider of time-zone rules to the system. |
Enums
| ZoneOffsetTransitionRule.TimeDefinition | A definition of the way a local time can be converted to the actual transition date-time. |
Exceptions
| ZoneRulesException | Thrown to indicate a problem with time-zone configuration. |