- 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.Dateclass that allows the JDBC API to identify this as an SQLTIMEvalue. TheTimeclass 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
 
- 
- 
Method SummaryAll Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description intgetDate()Deprecated.intgetDay()Deprecated.intgetMonth()Deprecated.intgetYear()Deprecated.voidsetDate(int i)Deprecated.voidsetMonth(int i)Deprecated.voidsetTime(long time)Sets aTimeobject using a milliseconds time value.voidsetYear(int i)Deprecated.InstanttoInstant()This method always throws an UnsupportedOperationException and should not be used because SQLTimevalues do not have a date component.LocalTimetoLocalTime()Converts thisTimeobject to aLocalTime.StringtoString()Formats a time in JDBC time escape format.static TimevalueOf(String s)Converts a string in JDBC time escape format to aTimevalue.static TimevalueOf(LocalTime time)Obtains an instance ofTimefrom aLocalTimeobject with the same hour, minute and second time value as the givenLocalTime.- 
Methods declared in class java.util.Dateafter, before, clone, compareTo, equals, from, getHours, getMinutes, getSeconds, getTime, getTimezoneOffset, hashCode, parse, setHours, setMinutes, setSeconds, toGMTString, toLocaleString, UTC
 
- 
 
- 
- 
- 
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 constructorConstructs aTimeobject 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 aTimeobject will throw ajava.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
 
 - 
Timepublic Time(long time) Constructs aTimeobject 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- 
setTimepublic void setTime(long time) Sets aTimeobject using a milliseconds time value.
 - 
valueOfpublic static Time valueOf(String s) Converts a string in JDBC time escape format to aTimevalue.- Parameters:
- s- time in format "hh:mm:ss"
- Returns:
- a corresponding Timeobject
 
 - 
toStringpublic String toString() Formats a time in JDBC time escape format.- Overrides:
- toStringin class- Date
- Returns:
- a Stringin 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 SQLTIMEvalues do not have a year component.- Overrides:
- getYearin class- Date
- Returns:
- the year represented by this date, minus 1900.
- Throws:
- IllegalArgumentException- if this method is invoked
- See Also:
- setYear(int)
 
 - 
getMonth@Deprecated(since="1.2") public int getMonth() Deprecated.This method is deprecated and should not be used because SQLTIMEvalues do not have a month component.- Overrides:
- getMonthin class- Date
- Returns:
- the month represented by this date.
- Throws:
- IllegalArgumentException- if this method is invoked
- See Also:
- setMonth(int)
 
 - 
getDay@Deprecated(since="1.2") public int getDay() Deprecated.This method is deprecated and should not be used because SQLTIMEvalues do not have a day component.- Overrides:
- getDayin class- Date
- Returns:
- the day of the week represented by this date.
- Throws:
- IllegalArgumentException- if this method is invoked
- See Also:
- Calendar
 
 - 
getDate@Deprecated(since="1.2") public int getDate() Deprecated.This method is deprecated and should not be used because SQLTIMEvalues do not have a date component.- Overrides:
- getDatein class- Date
- Returns:
- the day of the month represented by this date.
- Throws:
- IllegalArgumentException- if this method is invoked
- See Also:
- setDate(int)
 
 - 
setYear@Deprecated(since="1.2") public void setYear(int i) Deprecated.This method is deprecated and should not be used because SQLTIMEvalues do not have a year component.- Overrides:
- setYearin class- Date
- Parameters:
- i- the year value.
- Throws:
- IllegalArgumentException- if this method is invoked
- See Also:
- getYear()
 
 - 
setMonth@Deprecated(since="1.2") public void setMonth(int i) Deprecated.This method is deprecated and should not be used because SQLTIMEvalues do not have a month component.- Overrides:
- setMonthin class- Date
- Parameters:
- i- the month value between 0-11.
- Throws:
- IllegalArgumentException- if this method is invoked
- See Also:
- getMonth()
 
 - 
setDate@Deprecated(since="1.2") public void setDate(int i) Deprecated.This method is deprecated and should not be used because SQLTIMEvalues do not have a date component.- Overrides:
- setDatein class- Date
- Parameters:
- i- the day of the month value between 1-31.
- Throws:
- IllegalArgumentException- if this method is invoked
- See Also:
- getDate()
 
 - 
valueOfpublic static Time valueOf(LocalTime time) Obtains an instance ofTimefrom aLocalTimeobject with the same hour, minute and second time value as the givenLocalTime. The nanosecond field fromLocalTimeis not part of the newly createdTimeobject.- Parameters:
- time- a- LocalTimeto convert
- Returns:
- a Timeobject
- Throws:
- NullPointerException- if- timeis null
- Since:
- 1.8
 
 - 
toLocalTimepublic LocalTime toLocalTime() Converts thisTimeobject to aLocalTime.The conversion creates a LocalTimethat represents the same hour, minute, and second time value as thisTime. The nanosecondLocalTimefield will be set to zero.- Returns:
- a LocalTimeobject representing the same time value
- Since:
- 1.8
 
 - 
toInstantpublic Instant toInstant() This method always throws an UnsupportedOperationException and should not be used because SQLTimevalues do not have a date component.- Overrides:
- toInstantin class- Date
- Returns:
- an instant representing the same point on the time-line as
  this Dateobject
- Throws:
- UnsupportedOperationException- if this method is invoked
 
 
- 
 
-