Package java.sql

Class Time

  • All Implemented Interfaces:
    Serializable, Cloneable, Comparable<Date>
    public class Time
extends Date
    Java representation of an SQL TIME value. Provides utilities to format and parse the time's representation as a String in JDBC escape format.
    See Also:
    Serialized Form

    • Constructor Detail

      • Time

        @Deprecated
public Time​(int theHour,
            int theMinute,
            int theSecond)
        Deprecated.
        Use the constructor Time(long) instead.
        Constructs a Time object using the supplied values for Hour, Minute and Second. The Year, Month and Day elements of the Time object are set to the date of the Epoch (January 1, 1970).

        Any attempt to access the Year, Month or Day elements of a Time object will result in an IllegalArgumentException.

        The result is undefined if any argument is out of bounds.

        Parameters:
        theHour - a value in the range [0,23].
        theMinute - a value in the range [0,59].
        theSecond - a value in the range [0,59].

      • Time

        public Time​(long theTime)
        Constructs a Time object using a supplied time specified in milliseconds.
        Parameters:
        theTime - a Time specified in milliseconds since the Epoch (January 1st 1970, 00:00:00.000).

    • Method Detail

      • getDate

        @Deprecated
public int getDate()
        Deprecated.
        This method is deprecated and must not be used. An SQL Time object does not have a date component.
        Description copied from class: Date
        Returns the gregorian calendar day of the month for this Date object.
        Overrides:
        getDate in class Date
        Returns:
        does not return anything.
        Throws:
        IllegalArgumentException - if this method is called.

      • getDay

        @Deprecated
public int getDay()
        Deprecated.
        This method is deprecated and must not be used. An SQL Time object does not have a day component.
        Description copied from class: Date
        Returns the gregorian calendar day of the week for this Date object.
        Overrides:
        getDay in class Date
        Returns:
        does not return anything.
        Throws:
        IllegalArgumentException - if this method is called.

      • getMonth

        @Deprecated
public int getMonth()
        Deprecated.
        This method is deprecated and must not be used. An SQL Time object does not have a month component.
        Description copied from class: Date
        Returns the gregorian calendar month for this Date object.
        Overrides:
        getMonth in class Date
        Returns:
        does not return anything.
        Throws:
        IllegalArgumentException - if this method is called.

      • getYear

        @Deprecated
public int getYear()
        Deprecated.
        This method is deprecated and must not be used. An SQL Time object does not have a year component.
        Description copied from class: Date
        Returns the gregorian calendar year since 1900 for this Date object.
        Overrides:
        getYear in class Date
        Returns:
        does not return anything.
        Throws:
        IllegalArgumentException - if this method is called.

      • setDate

        @Deprecated
public void setDate​(int i)
        Deprecated.
        This method is deprecated and must not be used. An SQL Time object does not have a date component.
        Description copied from class: Date
        Sets the gregorian calendar day of the month for this Date object.
        Overrides:
        setDate in class Date
        Parameters:
        i - the day of the month.
        Throws:
        IllegalArgumentException - if this method is called.

      • setMonth

        @Deprecated
public void setMonth​(int i)
        Deprecated.
        This method is deprecated and must not be used. An SQL Time object does not have a month component.
        Description copied from class: Date
        Sets the gregorian calendar month for this Date object.
        Overrides:
        setMonth in class Date
        Parameters:
        i - the month.
        Throws:
        IllegalArgumentException - if this method is called.

      • setYear

        @Deprecated
public void setYear​(int i)
        Deprecated.
        This method is deprecated and must not be used. An SQL Time object does not have a year component.
        Description copied from class: Date
        Sets the gregorian calendar year since 1900 for this Date object.
        Overrides:
        setYear in class Date
        Parameters:
        i - the year since 1900.
        Throws:
        IllegalArgumentException - if this method is called.

      • setTime

        public void setTime​(long time)
        Sets the time for this Time object to the supplied milliseconds value.
        Overrides:
        setTime in class Date
        Parameters:
        time - A time value expressed as milliseconds since the Epoch. Negative values are milliseconds before the Epoch. The Epoch is January 1 1970, 00:00:00.000.

      • toString

        public String toString()
        Formats the Time as a String in JDBC escape format: hh:mm:ss.
        Overrides:
        toString in class Date
        Returns:
        A String representing the Time value in JDBC escape format: HH:mm:ss

      • valueOf

        public static Time valueOf​(String timeString)
        Creates a Time object from a string holding a time represented in JDBC escape format: hh:mm:ss.

        An exception occurs if the input string does not comply with this format.

        Parameters:
        timeString - A String representing the time value in JDBC escape format: hh:mm:ss.
        Returns:
        The Time object set to a time corresponding to the given time.
        Throws:
        IllegalArgumentException - if the supplied time string is not in JDBC escape format.