public class

Time

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

Class Overview

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.

Summary

Public Constructors
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 Methods
int getDate()
This method is deprecated. As of JDK version 1.1, replaced by Calendar.get(Calendar.DAY_OF_MONTH).No replacement.
int getDay()
This method is deprecated. As of JDK version 1.1, replaced by Calendar.get(Calendar.DAY_OF_WEEK).
int getMonth()
This method is deprecated. As of JDK version 1.1, replaced by Calendar.get(Calendar.MONTH).
int getYear()
This method is deprecated. As of JDK version 1.1, replaced by Calendar.get(Calendar.YEAR) - 1900.
void setDate(int i)
This method is deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.DAY_OF_MONTH, int date).
void setMonth(int i)
This method is deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.MONTH, int month).
void setTime(long time)
Sets a Time object using a milliseconds time value.
void setYear(int i)
This method is deprecated. As of JDK version 1.1, replaced by Calendar.set(Calendar.YEAR, year + 1900).
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.
[Expand]
Inherited Methods
From class java.util.Date
From class java.lang.Object
From interface java.lang.Comparable

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.
As of JDK version 1.1, replaced by Calendar.get(Calendar.DAY_OF_MONTH).No replacement.

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

Returns
  • the day of the month represented by this date.
Throws
IllegalArgumentException if this method is invoked
See Also

public int getDay ()

This method is deprecated.
As of JDK version 1.1, replaced by Calendar.get(Calendar.DAY_OF_WEEK).

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

Returns
  • the day of the week represented by this date.
Throws
IllegalArgumentException if this method is invoked

public int getMonth ()

This method is deprecated.
As of JDK version 1.1, replaced by Calendar.get(Calendar.MONTH).

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

Returns
  • the month represented by this date.
Throws
IllegalArgumentException if this method is invoked
See Also

public int getYear ()

This method is deprecated.
As of JDK version 1.1, replaced by Calendar.get(Calendar.YEAR) - 1900.

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

Returns
  • the year represented by this date, minus 1900.
Throws
IllegalArgumentException if this method is invoked
See Also

public void setDate (int i)

This method is deprecated.
As of JDK version 1.1, replaced by Calendar.set(Calendar.DAY_OF_MONTH, int date).

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

Parameters
i the day of the month value between 1-31.
Throws
IllegalArgumentException if this method is invoked
See Also

public void setMonth (int i)

This method is deprecated.
As of JDK version 1.1, replaced by Calendar.set(Calendar.MONTH, int month).

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

Parameters
i the month value between 0-11.
Throws
IllegalArgumentException if this method is invoked
See Also

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.
As of JDK version 1.1, replaced by Calendar.set(Calendar.YEAR, year + 1900).

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

Parameters
i the year value.
Throws
IllegalArgumentException if this method is invoked
See Also

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