/*

 * Copyright (c) 1996, 2016, Oracle and/or its affiliates. All rights reserved.

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

 *

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

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

 * published by the Free Software Foundation.  Oracle designates this

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

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

 *

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

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

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

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

 * accompanied this code).

 *

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

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

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

 *

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

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

 * questions.

 */

package java.sql;

import java.time.Instant;

import java.time.LocalTime;

/**

 * <P>A thin wrapper around the <code>java.util.Date</code> class that allows the JDBC

 * API to identify this as an SQL <code>TIME</code> value. The <code>Time</code>

 * class adds formatting and

 * parsing operations to support the JDBC escape syntax for time

 * values.

 * <p>The date components should be set to the "zero epoch"

 * value of January 1, 1970 and should not be accessed.

 *

 * @since 1.1

 */

public class Time extends java.util.Date {

    /**

     * Constructs a <code>Time</code> object initialized with the

     * given values for the hour, minute, and second.

     * The driver sets the date components to January 1, 1970.

     * Any method that attempts to access the date components of a

     * <code>Time</code> object will throw a

     * <code>java.lang.IllegalArgumentException</code>.

     * <P>

     * The result is undefined if a given argument is out of bounds.

     *

     * @param hour 0 to 23

     * @param minute 0 to 59

     * @param second 0 to 59

     *

     * @deprecated Use the constructor that takes a milliseconds value

     *             in place of this constructor

     */

    @Deprecated(since="1.2")

    public Time(int hour, int minute, int second) {

        super(70, 0, 1, hour, minute, second);

    }

    /**

     * Constructs a <code>Time</code> object using a milliseconds time value.

     *

     * @param time milliseconds since January 1, 1970, 00:00:00 GMT;

     *             a negative number is milliseconds before

     *               January 1, 1970, 00:00:00 GMT

     */

    public Time(long time) {

        super(time);

    }

    /**

     * Sets a <code>Time</code> object using a milliseconds time value.

     *

     * @param time milliseconds since January 1, 1970, 00:00:00 GMT;

     *             a negative number is milliseconds before

     *               January 1, 1970, 00:00:00 GMT

     */

    public void setTime(long time) {

        super.setTime(time);

    }

    /**

     * Converts a string in JDBC time escape format to a <code>Time</code> value.

     *

     * @param s time in format "hh:mm:ss"

     * @return a corresponding <code>Time</code> object

     */

    public static Time valueOf(String s) {

        if (s == null) throw new java.lang.IllegalArgumentException();

        int hour;

        int minute;

        int second;

        int firstColon = s.indexOf(':');

        int secondColon = s.indexOf(':', firstColon + 1);

        int len = s.length();

        if (firstColon > 0 && secondColon > 0 &&

                secondColon < len - 1) {

            hour = Integer.parseInt(s, 0, firstColon, 10);

            minute = Integer.parseInt(s, firstColon + 1, secondColon, 10);

            second = Integer.parseInt(s, secondColon + 1, len, 10);

        } else {

            throw new java.lang.IllegalArgumentException();

        }

        return new Time(hour, minute, second);

    }

    /**

     * Formats a time in JDBC time escape format.

     *

     * @return a <code>String</code> in hh:mm:ss format

     */

    @SuppressWarnings("deprecation")

    public String toString () {

        int hour = super.getHours();

        int minute = super.getMinutes();

        int second = super.getSeconds();

        char[] buf = new char[8];

        Date.formatDecimalInt(hour, buf, 0, 2);

        buf[2] = ':';

        Date.formatDecimalInt(minute, buf, 3, 2);

        buf[5] = ':';

        Date.formatDecimalInt(second, buf, 6, 2);

        return new String(buf);

    }

    // Override all the date operations inherited from java.util.Date;

   /**

    * This method is deprecated and should not be used because SQL <code>TIME</code>

    * values do not have a year component.

    *

    * @deprecated

    * @exception java.lang.IllegalArgumentException if this

    *           method is invoked

    * @see #setYear

    */

    @Deprecated(since="1.2")

    public int getYear() {

        throw new java.lang.IllegalArgumentException();

    }

   /**

    * This method is deprecated and should not be used because SQL <code>TIME</code>

    * values do not have a month component.

    *

    * @deprecated

    * @exception java.lang.IllegalArgumentException if this

    *           method is invoked

    * @see #setMonth

    */

    @Deprecated(since="1.2")

    public int getMonth() {

        throw new java.lang.IllegalArgumentException();

    }

   /**

    * This method is deprecated and should not be used because SQL <code>TIME</code>

    * values do not have a day component.

    *

    * @deprecated

    * @exception java.lang.IllegalArgumentException if this

    *           method is invoked

    */

    @Deprecated(since="1.2")

    public int getDay() {

        throw new java.lang.IllegalArgumentException();

    }

   /**

    * This method is deprecated and should not be used because SQL <code>TIME</code>

    * values do not have a date component.

    *

    * @deprecated

    * @exception java.lang.IllegalArgumentException if this

    *           method is invoked

    * @see #setDate

    */

    @Deprecated(since="1.2")

    public int getDate() {

        throw new java.lang.IllegalArgumentException();

    }

   /**

    * This method is deprecated and should not be used because SQL <code>TIME</code>

    * values do not have a year component.

    *

    * @deprecated

    * @exception java.lang.IllegalArgumentException if this

    *           method is invoked

    * @see #getYear

    */

    @Deprecated(since="1.2")

    public void setYear(int i) {

        throw new java.lang.IllegalArgumentException();

    }

   /**

    * This method is deprecated and should not be used because SQL <code>TIME</code>

    * values do not have a month component.

    *

    * @deprecated

    * @exception java.lang.IllegalArgumentException if this

    *           method is invoked

    * @see #getMonth

    */

    @Deprecated(since="1.2")

    public void setMonth(int i) {

        throw new java.lang.IllegalArgumentException();

    }

   /**

    * This method is deprecated and should not be used because SQL <code>TIME</code>

    * values do not have a date component.

    *

    * @deprecated

    * @exception java.lang.IllegalArgumentException if this

    *           method is invoked

    * @see #getDate

    */

    @Deprecated(since="1.2")

    public void setDate(int i) {

        throw new java.lang.IllegalArgumentException();

    }

   /**

    * Private serial version unique ID to ensure serialization

    * compatibility.

    */

    static final long serialVersionUID = 8397324403548013681L;

    /**

     * Obtains an instance of {@code Time} from a {@link LocalTime} object

     * with the same hour, minute and second time value as the given

     * {@code LocalTime}. The nanosecond field from {@code LocalTime} is

     * not part of the newly created {@code Time} object.

     *

     * @param time a {@code LocalTime} to convert

     * @return a {@code Time} object

     * @exception NullPointerException if {@code time} is null

     * @since 1.8

     */

    @SuppressWarnings("deprecation")

    public static Time valueOf(LocalTime time) {

        return new Time(time.getHour(), time.getMinute(), time.getSecond());

    }

    /**

     * Converts this {@code Time} object to a {@code LocalTime}.

     * <p>

     * The conversion creates a {@code LocalTime} that represents the same

     * hour, minute, and second time value as this {@code Time}. The

     * nanosecond {@code LocalTime} field will be set to zero.

     *

     * @return a {@code LocalTime} object representing the same time value

     * @since 1.8

     */

    @SuppressWarnings("deprecation")

    public LocalTime toLocalTime() {

        return LocalTime.of(getHours(), getMinutes(), getSeconds());

    }

   /**

    * This method always throws an UnsupportedOperationException and should

    * not be used because SQL {@code Time} values do not have a date

    * component.

    *

    * @exception java.lang.UnsupportedOperationException if this method is invoked

    */

    @Override

    public Instant toInstant() {

        throw new java.lang.UnsupportedOperationException();

    }

}