1 /*

     2  * Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved.

     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

     4  *

     5  * This code is free software; you can redistribute it and/or modify it

     6  * under the terms of the GNU General Public License version 2 only, as

     7  * published by the Free Software Foundation.  Oracle designates this

     8  * particular file as subject to the "Classpath" exception as provided

     9  * by Oracle in the LICENSE file that accompanied this code.

    10  *

    11  * This code is distributed in the hope that it will be useful, but WITHOUT

    12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

    13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

    14  * version 2 for more details (a copy is included in the LICENSE file that

    15  * accompanied this code).

    16  *

    17  * You should have received a copy of the GNU General Public License version

    18  * 2 along with this work; if not, write to the Free Software Foundation,

    19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

    20  *

    21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

    22  * or visit www.oracle.com if you need additional information or have any

    23  * questions.

    24  */

    25 

    26 /*

    27  * This file is available under and governed by the GNU General Public

    28  * License version 2 only, as published by the Free Software Foundation.

    29  * However, the following notice accompanied the original version of this

    30  * file:

    31  *

    32  * Copyright (c) 2007-2012, Stephen Colebourne & Michael Nascimento Santos

    33  *

    34  * All rights reserved.

    35  *

    36  * Redistribution and use in source and binary forms, with or without

    37  * modification, are permitted provided that the following conditions are met:

    38  *

    39  *  * Redistributions of source code must retain the above copyright notice,

    40  *    this list of conditions and the following disclaimer.

    41  *

    42  *  * Redistributions in binary form must reproduce the above copyright notice,

    43  *    this list of conditions and the following disclaimer in the documentation

    44  *    and/or other materials provided with the distribution.

    45  *

    46  *  * Neither the name of JSR-310 nor the names of its contributors

    47  *    may be used to endorse or promote products derived from this software

    48  *    without specific prior written permission.

    49  *

    50  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

    51  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT

    52  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR

    53  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR

    54  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,

    55  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,

    56  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR

    57  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF

    58  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING

    59  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

    60  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    61  */

    62 package java.time.temporal;

    63 

    64 import static java.time.temporal.ChronoField.EPOCH_DAY;

    65 

    66 import java.io.IOException;

    67 import java.io.InvalidObjectException;

    68 import java.io.ObjectInput;

    69 import java.io.ObjectOutput;

    70 import java.io.ObjectStreamException;

    71 import java.io.Serializable;

    72 import java.time.DateTimeException;

    73 import java.time.LocalTime;

    74 import java.time.ZoneId;

    75 import java.util.Objects;

    76 

    77 /**

    78  * A date-time without a time-zone for the calendar neutral API.

    79  * <p>

    80  * {@code ChronoLocalDateTime} is an immutable date-time object that represents a date-time, often

    81  * viewed as year-month-day-hour-minute-second. This object can also access other

    82  * fields such as day-of-year, day-of-week and week-of-year.

    83  * <p>

    84  * This class stores all date and time fields, to a precision of nanoseconds.

    85  * It does not store or represent a time-zone. For example, the value

    86  * "2nd October 2007 at 13:45.30.123456789" can be stored in an {@code ChronoLocalDateTime}.

    87  *

    88  * <h3>Specification for implementors</h3>

    89  * This class is immutable and thread-safe.

    90  *

    91  * @param <C> the chronology of this date

    92  * @since 1.8

    93  */

    94 final class ChronoLocalDateTimeImpl<C extends Chrono<C>>

    95         implements  ChronoLocalDateTime<C>, Temporal, TemporalAdjuster, Serializable {

    96 

    97     /**

    98      * Serialization version.

    99      */

   100     private static final long serialVersionUID = 4556003607393004514L;

   101     /**

   102      * Hours per day.

   103      */

   104     static final int HOURS_PER_DAY = 24;

   105     /**

   106      * Minutes per hour.

   107      */

   108     static final int MINUTES_PER_HOUR = 60;

   109     /**

   110      * Minutes per day.

   111      */

   112     static final int MINUTES_PER_DAY = MINUTES_PER_HOUR * HOURS_PER_DAY;

   113     /**

   114      * Seconds per minute.

   115      */

   116     static final int SECONDS_PER_MINUTE = 60;

   117     /**

   118      * Seconds per hour.

   119      */

   120     static final int SECONDS_PER_HOUR = SECONDS_PER_MINUTE * MINUTES_PER_HOUR;

   121     /**

   122      * Seconds per day.

   123      */

   124     static final int SECONDS_PER_DAY = SECONDS_PER_HOUR * HOURS_PER_DAY;

   125     /**

   126      * Milliseconds per day.

   127      */

   128     static final long MILLIS_PER_DAY = SECONDS_PER_DAY * 1000L;

   129     /**

   130      * Microseconds per day.

   131      */

   132     static final long MICROS_PER_DAY = SECONDS_PER_DAY * 1000_000L;

   133     /**

   134      * Nanos per second.

   135      */

   136     static final long NANOS_PER_SECOND = 1000_000_000L;

   137     /**

   138      * Nanos per minute.

   139      */

   140     static final long NANOS_PER_MINUTE = NANOS_PER_SECOND * SECONDS_PER_MINUTE;

   141     /**

   142      * Nanos per hour.

   143      */

   144     static final long NANOS_PER_HOUR = NANOS_PER_MINUTE * MINUTES_PER_HOUR;

   145     /**

   146      * Nanos per day.

   147      */

   148     static final long NANOS_PER_DAY = NANOS_PER_HOUR * HOURS_PER_DAY;

   149 

   150     /**

   151      * The date part.

   152      */

   153     private final ChronoLocalDate<C> date;

   154     /**

   155      * The time part.

   156      */

   157     private final LocalTime time;

   158 

   159     //-----------------------------------------------------------------------

   160     /**

   161      * Obtains an instance of {@code ChronoLocalDateTime} from a date and time.

   162      *

   163      * @param date  the local date, not null

   164      * @param time  the local time, not null

   165      * @return the local date-time, not null

   166      */

   167     static <R extends Chrono<R>> ChronoLocalDateTimeImpl<R> of(ChronoLocalDate<R> date, LocalTime time) {

   168         return new ChronoLocalDateTimeImpl<>(date, time);

   169     }

   170 

   171     /**

   172      * Constructor.

   173      *

   174      * @param date  the date part of the date-time, not null

   175      * @param time  the time part of the date-time, not null

   176      */

   177     private ChronoLocalDateTimeImpl(ChronoLocalDate<C> date, LocalTime time) {

   178         Objects.requireNonNull(date, "date");

   179         Objects.requireNonNull(time, "time");

   180         this.date = date;

   181         this.time = time;

   182     }

   183 

   184     /**

   185      * Returns a copy of this date-time with the new date and time, checking

   186      * to see if a new object is in fact required.

   187      *

   188      * @param newDate  the date of the new date-time, not null

   189      * @param newTime  the time of the new date-time, not null

   190      * @return the date-time, not null

   191      */

   192     private ChronoLocalDateTimeImpl<C> with(Temporal newDate, LocalTime newTime) {

   193         if (date == newDate && time == newTime) {

   194             return this;

   195         }

   196         // Validate that the new Temporal is a ChronoLocalDate (and not something else)

   197         ChronoLocalDate<C> cd = date.getChrono().ensureChronoLocalDate(newDate);

   198         return new ChronoLocalDateTimeImpl<>(cd, newTime);

   199     }

   200 

   201     //-----------------------------------------------------------------------

   202     @Override

   203     public ChronoLocalDate<C> getDate() {

   204         return date;

   205     }

   206 

   207     @Override

   208     public LocalTime getTime() {

   209         return time;

   210     }

   211 

   212     //-----------------------------------------------------------------------

   213     @Override

   214     public boolean isSupported(TemporalField field) {

   215         if (field instanceof ChronoField) {

   216             ChronoField f = (ChronoField) field;

   217             return f.isDateField() || f.isTimeField();

   218         }

   219         return field != null && field.doIsSupported(this);

   220     }

   221 

   222     @Override

   223     public ValueRange range(TemporalField field) {

   224         if (field instanceof ChronoField) {

   225             ChronoField f = (ChronoField) field;

   226             return (f.isTimeField() ? time.range(field) : date.range(field));

   227         }

   228         return field.doRange(this);

   229     }

   230 

   231     @Override

   232     public int get(TemporalField field) {

   233         if (field instanceof ChronoField) {

   234             ChronoField f = (ChronoField) field;

   235             return (f.isTimeField() ? time.get(field) : date.get(field));

   236         }

   237         return range(field).checkValidIntValue(getLong(field), field);

   238     }

   239 

   240     @Override

   241     public long getLong(TemporalField field) {

   242         if (field instanceof ChronoField) {

   243             ChronoField f = (ChronoField) field;

   244             return (f.isTimeField() ? time.getLong(field) : date.getLong(field));

   245         }

   246         return field.doGet(this);

   247     }

   248 

   249     //-----------------------------------------------------------------------

   250     @SuppressWarnings("unchecked")

   251     @Override

   252     public ChronoLocalDateTimeImpl<C> with(TemporalAdjuster adjuster) {

   253         if (adjuster instanceof ChronoLocalDate) {

   254             // The Chrono is checked in with(date,time)

   255             return with((ChronoLocalDate<C>) adjuster, time);

   256         } else if (adjuster instanceof LocalTime) {

   257             return with(date, (LocalTime) adjuster);

   258         } else if (adjuster instanceof ChronoLocalDateTimeImpl) {

   259             return date.getChrono().ensureChronoLocalDateTime((ChronoLocalDateTimeImpl<?>) adjuster);

   260         }

   261         return date.getChrono().ensureChronoLocalDateTime((ChronoLocalDateTimeImpl<?>) adjuster.adjustInto(this));

   262     }

   263 

   264     @Override

   265     public ChronoLocalDateTimeImpl<C> with(TemporalField field, long newValue) {

   266         if (field instanceof ChronoField) {

   267             ChronoField f = (ChronoField) field;

   268             if (f.isTimeField()) {

   269                 return with(date, time.with(field, newValue));

   270             } else {

   271                 return with(date.with(field, newValue), time);

   272             }

   273         }

   274         return date.getChrono().ensureChronoLocalDateTime(field.doWith(this, newValue));

   275     }

   276 

   277     //-----------------------------------------------------------------------

   278     @Override

   279     public ChronoLocalDateTimeImpl<C> plus(long amountToAdd, TemporalUnit unit) {

   280         if (unit instanceof ChronoUnit) {

   281             ChronoUnit f = (ChronoUnit) unit;

   282             switch (f) {

   283                 case NANOS: return plusNanos(amountToAdd);

   284                 case MICROS: return plusDays(amountToAdd / MICROS_PER_DAY).plusNanos((amountToAdd % MICROS_PER_DAY) * 1000);

   285                 case MILLIS: return plusDays(amountToAdd / MILLIS_PER_DAY).plusNanos((amountToAdd % MILLIS_PER_DAY) * 1000000);

   286                 case SECONDS: return plusSeconds(amountToAdd);

   287                 case MINUTES: return plusMinutes(amountToAdd);

   288                 case HOURS: return plusHours(amountToAdd);

   289                 case HALF_DAYS: return plusDays(amountToAdd / 256).plusHours((amountToAdd % 256) * 12);  // no overflow (256 is multiple of 2)

   290             }

   291             return with(date.plus(amountToAdd, unit), time);

   292         }

   293         return date.getChrono().ensureChronoLocalDateTime(unit.doPlus(this, amountToAdd));

   294     }

   295 

   296     private ChronoLocalDateTimeImpl<C> plusDays(long days) {

   297         return with(date.plus(days, ChronoUnit.DAYS), time);

   298     }

   299 

   300     private ChronoLocalDateTimeImpl<C> plusHours(long hours) {

   301         return plusWithOverflow(date, hours, 0, 0, 0);

   302     }

   303 

   304     private ChronoLocalDateTimeImpl<C> plusMinutes(long minutes) {

   305         return plusWithOverflow(date, 0, minutes, 0, 0);

   306     }

   307 

   308     ChronoLocalDateTimeImpl<C> plusSeconds(long seconds) {

   309         return plusWithOverflow(date, 0, 0, seconds, 0);

   310     }

   311 

   312     private ChronoLocalDateTimeImpl<C> plusNanos(long nanos) {

   313         return plusWithOverflow(date, 0, 0, 0, nanos);

   314     }

   315 

   316     //-----------------------------------------------------------------------

   317     private ChronoLocalDateTimeImpl<C> plusWithOverflow(ChronoLocalDate<C> newDate, long hours, long minutes, long seconds, long nanos) {

   318         // 9223372036854775808 long, 2147483648 int

   319         if ((hours | minutes | seconds | nanos) == 0) {

   320             return with(newDate, time);

   321         }

   322         long totDays = nanos / NANOS_PER_DAY +             //   max/24*60*60*1B

   323                 seconds / SECONDS_PER_DAY +                //   max/24*60*60

   324                 minutes / MINUTES_PER_DAY +                //   max/24*60

   325                 hours / HOURS_PER_DAY;                     //   max/24

   326         long totNanos = nanos % NANOS_PER_DAY +                    //   max  86400000000000

   327                 (seconds % SECONDS_PER_DAY) * NANOS_PER_SECOND +   //   max  86400000000000

   328                 (minutes % MINUTES_PER_DAY) * NANOS_PER_MINUTE +   //   max  86400000000000

   329                 (hours % HOURS_PER_DAY) * NANOS_PER_HOUR;          //   max  86400000000000

   330         long curNoD = time.toNanoOfDay();                          //   max  86400000000000

   331         totNanos = totNanos + curNoD;                              // total 432000000000000

   332         totDays += Math.floorDiv(totNanos, NANOS_PER_DAY);

   333         long newNoD = Math.floorMod(totNanos, NANOS_PER_DAY);

   334         LocalTime newTime = (newNoD == curNoD ? time : LocalTime.ofNanoOfDay(newNoD));

   335         return with(newDate.plus(totDays, ChronoUnit.DAYS), newTime);

   336     }

   337 

   338     //-----------------------------------------------------------------------

   339     @Override

   340     public ChronoZonedDateTime<C> atZone(ZoneId zone) {

   341         return ChronoZonedDateTimeImpl.ofBest(this, zone, null);

   342     }

   343 

   344     //-----------------------------------------------------------------------

   345     @Override

   346     public long periodUntil(Temporal endDateTime, TemporalUnit unit) {

   347         if (endDateTime instanceof ChronoLocalDateTime == false) {

   348             throw new DateTimeException("Unable to calculate period between objects of two different types");

   349         }

   350         @SuppressWarnings("unchecked")

   351         ChronoLocalDateTime<C> end = (ChronoLocalDateTime<C>) endDateTime;

   352         if (getDate().getChrono().equals(end.getDate().getChrono()) == false) {

   353             throw new DateTimeException("Unable to calculate period between two different chronologies");

   354         }

   355         if (unit instanceof ChronoUnit) {

   356             ChronoUnit f = (ChronoUnit) unit;

   357             if (f.isTimeUnit()) {

   358                 long amount = end.getLong(EPOCH_DAY) - date.getLong(EPOCH_DAY);

   359                 switch (f) {

   360                     case NANOS: amount = Math.multiplyExact(amount, NANOS_PER_DAY); break;

   361                     case MICROS: amount = Math.multiplyExact(amount, MICROS_PER_DAY); break;

   362                     case MILLIS: amount = Math.multiplyExact(amount, MILLIS_PER_DAY); break;

   363                     case SECONDS: amount = Math.multiplyExact(amount, SECONDS_PER_DAY); break;

   364                     case MINUTES: amount = Math.multiplyExact(amount, MINUTES_PER_DAY); break;

   365                     case HOURS: amount = Math.multiplyExact(amount, HOURS_PER_DAY); break;

   366                     case HALF_DAYS: amount = Math.multiplyExact(amount, 2); break;

   367                 }

   368                 return Math.addExact(amount, time.periodUntil(end.getTime(), unit));

   369             }

   370             ChronoLocalDate<C> endDate = end.getDate();

   371             if (end.getTime().isBefore(time)) {

   372                 endDate = endDate.minus(1, ChronoUnit.DAYS);

   373             }

   374             return date.periodUntil(endDate, unit);

   375         }

   376         return unit.between(this, endDateTime).getAmount();

   377     }

   378 

   379     //-----------------------------------------------------------------------

   380     private Object writeReplace() {

   381         return new Ser(Ser.CHRONO_LOCAL_DATE_TIME_TYPE, this);

   382     }

   383 

   384     /**

   385      * Defend against malicious streams.

   386      * @return never

   387      * @throws InvalidObjectException always

   388      */

   389     private Object readResolve() throws ObjectStreamException {

   390         throw new InvalidObjectException("Deserialization via serialization delegate");

   391     }

   392 

   393     void writeExternal(ObjectOutput out) throws IOException {

   394         out.writeObject(date);

   395         out.writeObject(time);

   396     }

   397 

   398     static ChronoLocalDateTime<?> readExternal(ObjectInput in) throws IOException, ClassNotFoundException {

   399         ChronoLocalDate<?> date = (ChronoLocalDate<?>) in.readObject();

   400         LocalTime time = (LocalTime) in.readObject();

   401         return date.atTime(time);

   402     }

   403 

   404     //-----------------------------------------------------------------------

   405     @Override

   406     public boolean equals(Object obj) {

   407         if (this == obj) {

   408             return true;

   409         }

   410         if (obj instanceof ChronoLocalDateTime) {

   411             return compareTo((ChronoLocalDateTime<?>) obj) == 0;

   412         }

   413         return false;

   414     }

   415 

   416     @Override

   417     public int hashCode() {

   418         return getDate().hashCode() ^ getTime().hashCode();

   419     }

   420 

   421     @Override

   422     public String toString() {

   423         return getDate().toString() + 'T' + getTime().toString();

   424     }

   425 

   426 }