Build 1.0_r1(from source)

java.sql
Class Time

java.lang.Object
  extended by java.util.Date
      extended by java.sql.Time
All Implemented Interfaces:
Serializable, Cloneable, Comparable<Date>

public class Time
extends Date

Java representation of an SQL TIME value. Provides functions to aid generation and interpretation of JDBC escape format for time values.

See Also:
Serialized Form

Constructor Summary
Time(int theHour, int theMinute, int theSecond)
          Deprecated. Please use the constructor Time(long) 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 1970, January, 1 reflecting the Epoch (Time in milliseconds = 0).

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

Result is undefined if any argument is out of bounds.

Time(long theTime)
          Constructs a Time object using a supplied time specified in milliseconds
 
Method Summary
 int getDate()
          Deprecated. This method is deprecated and must not be used. An SQL Time object does not have a Date component.
 int getDay()
          Deprecated. This method is deprecated and must not be used. An SQL Time object does not have a Day component.
 int getMonth()
          Deprecated. This method is deprecated and must not be used. An SQL Time object does not have a Month component.
 int getYear()
          Deprecated. This method is deprecated and must not be used. An SQL Time object does not have a Year component.
 void setDate(int i)
          Deprecated. This method is deprecated and must not be used. An SQL Time object does not have a Date component.
 void setMonth(int i)
          Deprecated. This method is deprecated and must not be used. An SQL Time object does not have a Month component.
 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. An SQL Time object does not have a Year component.
 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 Detail

Time

@Deprecated
public Time(int theHour,
                       int theMinute,
                       int theSecond)
Deprecated. Please use the constructor Time(long) 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 1970, January, 1 reflecting the Epoch (Time in milliseconds = 0).

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

Result is undefined if any argument is out of bounds.

Parameters:
theHour - a value from 0 - 23
theMinute - a value from 0 - 59
theSecond - a value from 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
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
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
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
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 is not in the form of a time in JDBC escape 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.

Build 1.0_r1(from source)

Please submit a feedback, bug or feature