java.sql
class Time

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

All Implemented Interfaces:

Serializable, Cloneable, Comparable

public class Time
extends Date

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.

Time

public Time(int hour,
            int minute,
            int 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

Time

public Time(long 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

getDate

public int getDate()

This method is deprecated and should not be used because SQL TIME values do not have a date component.

Overrides:

getDate in class Date

getDay

public int getDay()

This method is deprecated and should not be used because SQL TIME values do not have a day component.

Overrides:

getDay in class Date

getMonth

public int getMonth()

This method is deprecated and should not be used because SQL TIME values do not have a month component.

Overrides:

getMonth in class Date

getYear

public int getYear()

This method is deprecated and should not be used because SQL TIME values do not have a year component.

Overrides:

getYear in class Date

setDate

public void setDate(int i)

This method is deprecated and should not be used because SQL TIME values do not have a date component.

Overrides:

setDate in class Date

Parameters:

i

setMonth

public void setMonth(int i)

This method is deprecated and should not be used because SQL TIME values do not have a month component.

Overrides:

setMonth in class Date

Parameters:

i

setTime

public void setTime(long time)

Sets a Time object using a milliseconds time value.

Overrides:

setTime in class Date

Parameters:

time - milliseconds since January 1, 1970, 00:00:00 GMT; a negative number is milliseconds before January 1, 1970, 00:00:00 GMT

setYear

public void setYear(int i)

This method is deprecated and should not be used because SQL TIME values do not have a year component.

Overrides:

setYear in class Date

Parameters:

i

toString

public String toString()

Formats a time in JDBC time escape format.

Overrides:

toString in class Date

Returns:

a String in hh:mm:ss format

valueOf

public static Time valueOf(String s)

Converts a string in JDBC time escape format to a Time value.

Parameters:

s - time in format "hh:mm:ss"

Returns:

a corresponding Time object