Package java.sql

Class Time

java.lang.Object
java.util.Date
java.sql.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 Summary

    Constructors
    Constructor Description
    Time​(int theHour, int theMinute, int theSecond)
    Deprecated.
    Use the constructor Time(long) instead.
    Time​(long theTime)
    Constructs a Time object using a supplied time specified in milliseconds.

  • Method Summary

    Modifier and Type Method Description
    int getDate()
    Deprecated.
    This method is deprecated and must not be used.
    int getDay()
    Deprecated.
    This method is deprecated and must not be used.
    int getMonth()
    Deprecated.
    This method is deprecated and must not be used.
    int getYear()
    Deprecated.
    This method is deprecated and must not be used.
    void setDate​(int i)
    Deprecated.
    This method is deprecated and must not be used.
    void setMonth​(int i)
    Deprecated.
    This method is deprecated and must not be used.
    void setTime​(long time)
    Sets the time for this Time object to the supplied milliseconds value.
    void setYear​(int i)
    Deprecated.
    This method is deprecated and must not be used.
    String toString()
    Formats the Time as a String in JDBC escape format: hh:mm:ss.
    static Time valueOf​(String timeString)
    Creates a Time object from a string holding a time represented in JDBC escape format: hh:mm:ss.

    Methods inherited from class java.util.Date

    after, before, clone, compareTo, equals, getHours, getMinutes, getSeconds, getTime, getTimezoneOffset, hashCode, parse, setHours, setMinutes, setSeconds, toGMTString, toLocaleString, UTC

    Methods inherited from class java.lang.Object

    finalize, getClass, notify, notifyAll, wait, wait, wait

  • Constructor Details

    • 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 Details

    • 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.