Module java.sql

Package java.sql

Class Time

java.lang.Object

java.util.Date

java.sql.Time

All Implemented Interfaces:

Serializable, Cloneable, Comparable<Date>

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.

Since:

1.1

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
Time(int hour, int minute, int second)	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.

Method Summary

Modifier and Type	Method	Description
int	getDate()	Deprecated.
int	getDay()	Deprecated.
int	getMonth()	Deprecated.
int	getYear()	Deprecated.
void	setDate(int i)	Deprecated.
void	setMonth(int i)	Deprecated.
void	setTime(long time)	Sets a Time object using a milliseconds time value.
void	setYear(int i)	Deprecated.
Instant	toInstant()	This method always throws an UnsupportedOperationException and should not be used because SQL Time values do not have a date component.
LocalTime	toLocalTime()	Converts this Time object to a LocalTime.
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.
static Time	valueOf(LocalTime time)	Obtains an instance of Time from a LocalTime object with the same hour, minute and second time value as the given LocalTime.

Methods inherited from class java.util.Date

after, before, clone, compareTo, equals, from, 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(since="1.2")
public Time(int hour,
            int minute,
            int second)

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

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

Method Detail

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

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

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

See Also:

Date.toLocaleString(), Date.toGMTString()

getYear

@Deprecated(since="1.2")
public int getYear()

Deprecated.

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

Overrides: