jdk/src/java.sql/share/classes/java/sql/Time.java - platform/libcore - Git at Google

 /*
  * 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;
 import jdk.internal.misc.SharedSecrets;
 import jdk.internal.misc.JavaLangAccess;

 /**
  * <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.
  */
 public class Time extends java.util.Date {

     private static final JavaLangAccess jla = SharedSecrets.getJavaLangAccess();

     /**
      * 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 jla.newStringUnsafe(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();
     }
 }
	/*
	* 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;
	import jdk.internal.misc.SharedSecrets;
	import jdk.internal.misc.JavaLangAccess;

	/**
	* <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.
	*/
	public class Time extends java.util.Date {

	private static final JavaLangAccess jla = SharedSecrets.getJavaLangAccess();

	/**
	* 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 jla.newStringUnsafe(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();
	}
	}