src/share/classes/java/time/zone/package-info.java

Print this page
rev 10048 : 8044740: Convert all JDK versions used in @since tag to 1.n[.n] in jdk repo
Reviewed-by:


  64  * <p>
  65  * Support for time-zones and their rules.
  66  * </p>
  67  * <p>
  68  * Daylight Saving Time and Time-Zones are concepts used by Governments to alter local time.
  69  * This package provides support for time-zones, their rules and the resulting
  70  * gaps and overlaps in the local time-line typically caused by Daylight Saving Time.
  71  * </p>
  72  *
  73  * <h3>Package specification</h3>
  74  * <p>
  75  * Unless otherwise noted, passing a null argument to a constructor or method in any class or interface
  76  * in this package will cause a {@link java.lang.NullPointerException NullPointerException} to be thrown.
  77  * The Javadoc "@param" definition is used to summarise the null-behavior.
  78  * The "@throws {@link java.lang.NullPointerException}" is not explicitly documented in each method.
  79  * </p>
  80  * <p>
  81  * All calculations should check for numeric overflow and throw either an {@link java.lang.ArithmeticException}
  82  * or a {@link java.time.DateTimeException}.
  83  * </p>
  84  * @since JDK1.8
  85  */
  86 package java.time.zone;


  64  * <p>
  65  * Support for time-zones and their rules.
  66  * </p>
  67  * <p>
  68  * Daylight Saving Time and Time-Zones are concepts used by Governments to alter local time.
  69  * This package provides support for time-zones, their rules and the resulting
  70  * gaps and overlaps in the local time-line typically caused by Daylight Saving Time.
  71  * </p>
  72  *
  73  * <h3>Package specification</h3>
  74  * <p>
  75  * Unless otherwise noted, passing a null argument to a constructor or method in any class or interface
  76  * in this package will cause a {@link java.lang.NullPointerException NullPointerException} to be thrown.
  77  * The Javadoc "@param" definition is used to summarise the null-behavior.
  78  * The "@throws {@link java.lang.NullPointerException}" is not explicitly documented in each method.
  79  * </p>
  80  * <p>
  81  * All calculations should check for numeric overflow and throw either an {@link java.lang.ArithmeticException}
  82  * or a {@link java.time.DateTimeException}.
  83  * </p>
  84  * @since 1.8
  85  */
  86 package java.time.zone;