Home » openjdk-7 » java » sql » [javadoc | source]

java.sql
public class: Time [javadoc | source]

java.lang.Object
   java.util.Date
      java.sql.Time

All Implemented Interfaces:
    Cloneable, Serializable, Comparable

A thin wrapper around the java.util.Date class that allows the JDBC API to identify this as an SQL TIME value. The Time class adds formatting and parsing operations to support the JDBC escape syntax for time values.

The date components should be set to the "zero epoch" value of January 1, 1970 and should not be accessed.

Field Summary
static final  long	serialVersionUID	Private serial version unique ID to ensure serialization compatibility.

Constructor:
public Time(long time) { super(time); } Constructs a Time object using a milliseconds time value. Parameters: 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(int hour, int minute, int second) { super(70, 0, 1, hour, minute, second); } Constructs a Time 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 Time object will throw a java.lang.IllegalArgumentException. The result is undefined if a given argument is out of bounds. Parameters: hour - 0 to 23 minute - 0 to 59 second - 0 to 59

Method from java.sql.Time Summary:
getDate,   getDay,   getMonth,   getYear,   setDate,   setMonth,   setTime,   setYear,   toString,   valueOf

Methods from java.util.Date:
UTC,   after,   before,   clone,   compareTo,   equals,   getDate,   getDay,   getHours,   getMillisOf,   getMinutes,   getMonth,   getSeconds,   getTime,   getTimezoneOffset,   getYear,   hashCode,   parse,   setDate,   setHours,   setMinutes,   setMonth,   setSeconds,   setTime,   setYear,   toGMTString,   toLocaleString,   toString

Methods from java.lang.Object:
clone,   equals,   finalize,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait

Method from java.sql.Time Detail:
public int getDate() { throw new java.lang.IllegalArgumentException(); } Deprecated! This method is deprecated and should not be used because SQL TIME values do not have a date component.
public int getDay() { throw new java.lang.IllegalArgumentException(); } Deprecated! This method is deprecated and should not be used because SQL TIME values do not have a day component.
public int getMonth() { throw new java.lang.IllegalArgumentException(); } Deprecated! This method is deprecated and should not be used because SQL TIME values do not have a month component.
public int getYear() { throw new java.lang.IllegalArgumentException(); } Deprecated! This method is deprecated and should not be used because SQL TIME values do not have a year component.
public void setDate(int i) { throw new java.lang.IllegalArgumentException(); } Deprecated! This method is deprecated and should not be used because SQL TIME values do not have a date component.
public void setMonth(int i) { throw new java.lang.IllegalArgumentException(); } Deprecated! This method is deprecated and should not be used because SQL TIME values do not have a month component.
public void setTime(long time) { super.setTime(time); } Sets a Time object using a milliseconds time value.
public void setYear(int i) { throw new java.lang.IllegalArgumentException(); } Deprecated! This method is deprecated and should not be used because SQL TIME values do not have a year component.
public String toString() { int hour = super.getHours(); int minute = super.getMinutes(); int second = super.getSeconds(); String hourString; String minuteString; String secondString; if (hour < 10) { hourString = "0" + hour; } else { hourString = Integer.toString(hour); } if (minute < 10) { minuteString = "0" + minute; } else { minuteString = Integer.toString(minute); } if (second < 10) { secondString = "0" + second; } else { secondString = Integer.toString(second); } return (hourString + ":" + minuteString + ":" + secondString); } Formats a time in JDBC time escape format.
public static Time valueOf(String s) { int hour; int minute; int second; int firstColon; int secondColon; if (s == null) throw new java.lang.IllegalArgumentException(); firstColon = s.indexOf(':"); secondColon = s.indexOf(':", firstColon+1); if ((firstColon > 0) & (secondColon > 0) & (secondColon < s.length()-1)) { hour = Integer.parseInt(s.substring(0, firstColon)); minute = Integer.parseInt(s.substring(firstColon+1, secondColon)); second = Integer.parseInt(s.substring(secondColon+1)); } else { throw new java.lang.IllegalArgumentException(); } return new Time(hour, minute, second); } Converts a string in JDBC time escape format to a Time value.