< prev index next >

src/java.base/share/classes/java/time/LocalDateTime.java

Print this page

 116  * The ISO-8601 calendar system is the modern civil calendar system used today
 117  * in most of the world. It is equivalent to the proleptic Gregorian calendar
 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.
 120  * However, any application that makes use of historical dates, and requires them
 121  * to be accurate will find the ISO-8601 approach unsuitable.
 122  * <p>
 123  * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
 124  * class; programmers should treat instances that are
 125  * {@linkplain #equals(Object) equal} as interchangeable and should not
 126  * use instances for synchronization, or unpredictable behavior may
 127  * occur. For example, in a future release, synchronization may fail.
 128  * The {@code equals} method should be used for comparisons.
 129  *
 130  * @implSpec
 131  * This class is immutable and thread-safe.
 132  *
 133  * @since 1.8
 134  */
 135 @jdk.internal.ValueBased

 136 public final class LocalDateTime
 137         implements Temporal, TemporalAdjuster, ChronoLocalDateTime<LocalDate>, Serializable {
 138 
 139     /**
 140      * The minimum supported {@code LocalDateTime}, '-999999999-01-01T00:00:00'.
 141      * This is the local date-time of midnight at the start of the minimum date.
 142      * This combines {@link LocalDate#MIN} and {@link LocalTime#MIN}.
 143      * This could be used by an application as a "far past" date-time.
 144      */
 145     public static final LocalDateTime MIN = LocalDateTime.of(LocalDate.MIN, LocalTime.MIN);
 146     /**
 147      * The maximum supported {@code LocalDateTime}, '+999999999-12-31T23:59:59.999999999'.
 148      * This is the local date-time just before midnight at the end of the maximum date.
 149      * This combines {@link LocalDate#MAX} and {@link LocalTime#MAX}.
 150      * This could be used by an application as a "far future" date-time.
 151      */
 152     public static final LocalDateTime MAX = LocalDateTime.of(LocalDate.MAX, LocalTime.MAX);
 153 
 154     /**
 155      * Serialization version.

 116  * The ISO-8601 calendar system is the modern civil calendar system used today
 117  * in most of the world. It is equivalent to the proleptic Gregorian calendar
 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.
 120  * However, any application that makes use of historical dates, and requires them
 121  * to be accurate will find the ISO-8601 approach unsuitable.
 122  * <p>
 123  * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
 124  * class; programmers should treat instances that are
 125  * {@linkplain #equals(Object) equal} as interchangeable and should not
 126  * use instances for synchronization, or unpredictable behavior may
 127  * occur. For example, in a future release, synchronization may fail.
 128  * The {@code equals} method should be used for comparisons.
 129  *
 130  * @implSpec
 131  * This class is immutable and thread-safe.
 132  *
 133  * @since 1.8
 134  */
 135 @jdk.internal.ValueBased
 136 @jdk.internal.MigratedValueClass
 137 public final class LocalDateTime
 138         implements Temporal, TemporalAdjuster, ChronoLocalDateTime<LocalDate>, Serializable {
 139 
 140     /**
 141      * The minimum supported {@code LocalDateTime}, '-999999999-01-01T00:00:00'.
 142      * This is the local date-time of midnight at the start of the minimum date.
 143      * This combines {@link LocalDate#MIN} and {@link LocalTime#MIN}.
 144      * This could be used by an application as a "far past" date-time.
 145      */
 146     public static final LocalDateTime MIN = LocalDateTime.of(LocalDate.MIN, LocalTime.MIN);
 147     /**
 148      * The maximum supported {@code LocalDateTime}, '+999999999-12-31T23:59:59.999999999'.
 149      * This is the local date-time just before midnight at the end of the maximum date.
 150      * This combines {@link LocalDate#MAX} and {@link LocalTime#MAX}.
 151      * This could be used by an application as a "far future" date-time.
 152      */
 153     public static final LocalDateTime MAX = LocalDateTime.of(LocalDate.MAX, LocalTime.MAX);
 154 
 155     /**
 156      * Serialization version.
< prev index next >