Time

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.

Public Constructor Summary

	Time(int hour, int minute, int second) This constructor is deprecated. Use the constructor that takes a milliseconds value in place of this constructor
	Time(long time) Constructs a Time object using a milliseconds time value.

Public Method Summary

int	getDate() This method is deprecated. This method is deprecated and should not be used because SQL TIME values do not have a date component.
int	getDay() This method is deprecated. This method is deprecated and should not be used because SQL TIME values do not have a day component.
int	getMonth() This method is deprecated. This method is deprecated and should not be used because SQL TIME values do not have a month component.
int	getYear() This method is deprecated. This method is deprecated and should not be used because SQL TIME values do not have a year component.
void	setDate(int i) This method is deprecated. This method is deprecated and should not be used because SQL TIME values do not have a date component.
void	setMonth(int i) This method is deprecated. This method is deprecated and should not be used because SQL TIME values do not have a month component.
void	setTime(long time) Sets a Time object using a milliseconds time value.
void	setYear(int i) This method is deprecated. This method is deprecated and should not be used because SQL TIME values do not have a year component.
String	toString() Formats a time in JDBC time escape format.
static Time	valueOf(String s) Converts a string in JDBC time escape format to a Time value.

Inherited Method Summary

From class java.util.Date

static long	UTC(int year, int month, int date, int hrs, int min, int sec) This method is deprecated. As of JDK version 1.1, replaced by Calendar.set(year + 1900, month, date, hrs, min, sec) or GregorianCalendar(year + 1900, month, date, hrs, min, sec), using a UTC TimeZone, followed by Calendar.getTime().getTime().
boolean	after(Date when) Tests if this date is after the specified date.
boolean	before(Date when) Tests if this date is before the specified date.
Object	clone() Return a copy of this object.
int	compareTo(Date anotherDate) Compares two Dates for ordering.
boolean	equals(Object obj) Compares two dates for equality.
int	getDate() This method is deprecated. As of JDK version 1.1, replaced by Calendar.get(Calendar.DAY_OF_MONTH).
int	getDay() This method is deprecated. As of JDK version 1.1, replaced by Calendar.get(Calendar.DAY_OF_WEEK).
int	getHours() This method is deprecated. As of JDK version 1.1, replaced by Calendar.get(Calendar.HOUR_OF_DAY).
int	getMinutes() This method is deprecated. As of JDK version 1.1, replaced by Calendar.get(Calendar.MINUTE).
int	getMonth() This method is deprecated. As of JDK version 1.1, replaced by Calendar.get(Calendar.MONTH).
int	getSeconds() This method is deprecated. As of JDK version 1.1, replaced by Calendar.get(Calendar.SECOND).
long	getTime() Returns the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by this Date object.
int	getTimezoneOffset() This method is deprecated. As of JDK version 1.1, replaced by -(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / (60 * 1000).
int	getYear() This method is deprecated. As of JDK version 1.1, replaced by Calendar.get(Calendar.YEAR) - 1900.
int	hashCode() Returns a hash code value for this object.
static long	parse(String s) This method is deprecated. As of JDK version 1.1, replaced by DateFormat.parse(String s).
void	setDate(int date) This method is deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.DAY_OF_MONTH, int date).
void	setHours(int hours) This method is deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.HOUR_OF_DAY, int hours).
void	setMinutes(int minutes) This method is deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.MINUTE, int minutes).
void	setMonth(int month) This method is deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.MONTH, int month).
void	setSeconds(int seconds) This method is deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.SECOND, int seconds).
void	setTime(long time) Sets this Date object to represent a point in time that is time milliseconds after January 1, 1970 00:00:00 GMT.
void	setYear(int year) This method is deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.YEAR, year + 1900).
String	toGMTString() This method is deprecated. As of JDK version 1.1, replaced by DateFormat.format(Date date), using a GMT TimeZone.
String	toLocaleString() This method is deprecated. As of JDK version 1.1, replaced by DateFormat.format(Date date).
String	toString() Converts this Date object to a String of the form: dow mon dd hh:mm:ss zzz yyyy where: dow is the day of the week (Sun, Mon, Tue, Wed, Thu, Fri, Sat).

From class java.lang.Object

Object	clone() Creates and returns a copy of this Object.
boolean	equals(Object obj) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of Class that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait(long timeout, int nanos) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait(long timeout) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait() Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object.

From interface java.lang.Comparable

abstract int

compareTo(Date o) Compares this object with the specified object for order.

Public Constructors

public Time (int hour, int minute, int second)

This constructor is deprecated.
Use the constructor that takes a milliseconds value in place of this constructor

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

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

Public Methods

public int getDate ()

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

Returns the day of the month represented by this Date object. The value returned is between 1 and 31 representing the day of the month that contains or begins with the instant in time represented by this Date object, as interpreted in the local time zone.

Returns

• the day of the month represented by this date.

Throws

IllegalArgumentException	if this method is invoked

See Also

• setDate(int)

public int getDay ()

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

Returns the day of the week represented by this date. The returned value (0 = Sunday, 1 = Monday, 2 = Tuesday, 3 = Wednesday, 4 = Thursday, 5 = Friday, 6 = Saturday) represents the day of the week that contains or begins with the instant in time represented by this Date object, as interpreted in the local time zone.

Returns

• the day of the week represented by this date.

Throws

IllegalArgumentException	if this method is invoked

public int getMonth ()

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

Returns a number representing the month that contains or begins with the instant in time represented by this Date object. The value returned is between 0 and 11, with the value 0 representing January.

Returns

• the month represented by this date.

Throws

IllegalArgumentException	if this method is invoked

See Also

• setMonth(int)

public int getYear ()

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

Returns a value that is the result of subtracting 1900 from the year that contains or begins with the instant in time represented by this Date object, as interpreted in the local time zone.

Returns

• the year represented by this date, minus 1900.

Throws

IllegalArgumentException	if this method is invoked

See Also

• setYear(int)

public void setDate (int i)

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

Sets the day of the month of this Date object to the specified value. This Date object is modified so that it represents a point in time within the specified day of the month, with the year, month, hour, minute, and second the same as before, as interpreted in the local time zone. If the date was April 30, for example, and the date is set to 31, then it will be treated as if it were on May 1, because April has only 30 days.

Parameters

i	the day of the month value between 1-31.

Throws

IllegalArgumentException	if this method is invoked

See Also

• getDate()

public void setMonth (int i)

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

Sets the month of this date to the specified value. This Date object is modified so that it represents a point in time within the specified month, with the year, date, hour, minute, and second the same as before, as interpreted in the local time zone. If the date was October 31, for example, and the month is set to June, then the new date will be treated as if it were on July 1, because June has only 30 days.

Parameters

i	the month value between 0-11.

Throws

IllegalArgumentException	if this method is invoked

See Also

• getMonth()

public void setTime (long time)

Sets 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 void setYear (int i)

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

Sets the year of this Date object to be the specified value plus 1900. This Date object is modified so that it represents a point in time within the specified year, with the month, date, hour, minute, and second the same as before, as interpreted in the local time zone. (Of course, if the date was February 29, for example, and the year is set to a non-leap year, then the new date will be treated as if it were on March 1.)

Parameters

i	the year value.

Throws

IllegalArgumentException	if this method is invoked

See Also

• getYear()

public String toString ()

Formats a time in JDBC time escape format.

Returns

• a String in hh:mm:ss format

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