Class Time
java.lang.Object
java.util.Date
java.sql.Time
- All Implemented Interfaces:
Serializable
,Cloneable
,Comparable<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:
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionint
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 aTime
object using a milliseconds time value.void
setYear
(int i) Deprecated.This method always throws an UnsupportedOperationException and should not be used because SQLTime
values do not have a date component.Converts thisTime
object to aLocalTime
.toString()
Formats a time in JDBC time escape format.static Time
Converts a string in JDBC time escape format to aTime
value.static Time
Obtains an instance ofTime
from aLocalTime
object with the same hour, minute and second time value as the givenLocalTime
.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
-
Constructor Details
-
Time
Deprecated.Use the constructor that takes a milliseconds value in place of this constructorConstructs aTime
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 aTime
object will throw ajava.lang.IllegalArgumentException
.The result is undefined if a given argument is out of bounds.
- Parameters:
hour
- 0 to 23minute
- 0 to 59second
- 0 to 59
-
Time
public Time(long time) Constructs aTime
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 Details
-
setTime
-
valueOf
-
toString
-
getYear
Deprecated.This method is deprecated and should not be used because SQLTIME
values do not have a year component.- Overrides:
getYear
in classDate
- Returns:
- the year represented by this date, minus 1900.
- Throws:
IllegalArgumentException
- if this method is invoked- See Also:
-
getMonth
Deprecated.This method is deprecated and should not be used because SQLTIME
values do not have a month component.- Overrides:
getMonth
in classDate
- Returns:
- the month represented by this date.
- Throws:
IllegalArgumentException
- if this method is invoked- See Also:
-
getDay
Deprecated.This method is deprecated and should not be used because SQLTIME
values do not have a day component.- Overrides:
getDay
in classDate
- Returns:
- the day of the week represented by this date.
- Throws:
IllegalArgumentException
- if this method is invoked- See Also:
-
getDate
Deprecated.This method is deprecated and should not be used because SQLTIME
values do not have a date component.- Overrides:
getDate
in classDate
- Returns:
- the day of the month represented by this date.
- Throws:
IllegalArgumentException
- if this method is invoked- See Also:
-
setYear
Deprecated.This method is deprecated and should not be used because SQLTIME
values do not have a year component.- Overrides:
setYear
in classDate
- Parameters:
i
- the year value.- Throws:
IllegalArgumentException
- if this method is invoked- See Also:
-
setMonth
Deprecated.This method is deprecated and should not be used because SQLTIME
values do not have a month component.- Overrides:
setMonth
in classDate
- Parameters:
i
- the month value between 0-11.- Throws:
IllegalArgumentException
- if this method is invoked- See Also:
-
setDate
Deprecated.This method is deprecated and should not be used because SQLTIME
values do not have a date component.- Overrides:
setDate
in classDate
- Parameters:
i
- the day of the month value between 1-31.- Throws:
IllegalArgumentException
- if this method is invoked- See Also:
-
valueOf
Obtains an instance ofTime
from aLocalTime
object with the same hour, minute and second time value as the givenLocalTime
. The nanosecond field fromLocalTime
is not part of the newly createdTime
object.- Parameters:
time
- aLocalTime
to convert- Returns:
- a
Time
object - Throws:
NullPointerException
- iftime
is null- Since:
- 1.8
-
toLocalTime
Converts thisTime
object to aLocalTime
.The conversion creates a
LocalTime
that represents the same hour, minute, and second time value as thisTime
. The nanosecondLocalTime
field will be set to zero.- Returns:
- a
LocalTime
object representing the same time value - Since:
- 1.8
-
toInstant
This method always throws an UnsupportedOperationException and should not be used because SQLTime
values do not have a date component.- Overrides:
toInstant
in classDate
- Returns:
- an instant representing the same point on the time-line as
this
Date
object - Throws:
UnsupportedOperationException
- if this method is invoked
-