jdk/src/share/classes/java/time/Year.java
changeset 22108 99859c0e9a33
parent 22081 86eb26ff8f2b
child 22566 4ebe53dd7814
equal deleted inserted replaced
22107:3e6b0718041e 22108:99859c0e9a33
   118  * system, in which today's rules for leap years are applied for all time.
   118  * system, in which today's rules for leap years are applied for all time.
   119  * For most applications written today, the ISO-8601 rules are entirely suitable.
   119  * For most applications written today, the ISO-8601 rules are entirely suitable.
   120  * However, any application that makes use of historical dates, and requires them
   120  * However, any application that makes use of historical dates, and requires them
   121  * to be accurate will find the ISO-8601 approach unsuitable.
   121  * to be accurate will find the ISO-8601 approach unsuitable.
   122  *
   122  *
       
   123  * <p>
       
   124  * This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a>
       
   125  * class; use of identity-sensitive operations (including reference equality
       
   126  * ({@code ==}), identity hash code, or synchronization) on instances of
       
   127  * {@code Year} may have unpredictable results and should be avoided.
       
   128  * The {@code equals} method should be used for comparisons.
       
   129  *
   123  * @implSpec
   130  * @implSpec
   124  * This class is immutable and thread-safe.
   131  * This class is immutable and thread-safe.
   125  *
   132  *
   126  * @since 1.8
   133  * @since 1.8
   127  */
   134  */