Time (Java Platform SE 7 b138)

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.

See Also:
Serialized Form

Constructor Summary

Constructors
Constructor and 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

Methods
Modifier and Type	Method and 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.
`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.

Methods inherited from class java.util.Date
after, before, clone, compareTo, equals, 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
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
public int getYear()
```
    Deprecated.
    
    This method is deprecated and should not be used because SQL TIME values do not have a year component.
    
    Overrides:
    
    getYear in class Date
    
    Returns:
    the year represented by this date, minus 1900.
    
    Throws:
    
    IllegalArgumentException - if this method is invoked
    See Also:
    setYear(int)
  - getMonth
```
@Deprecated
public int getMonth()
```
    Deprecated.
    
    This method is deprecated and should not be used because SQL TIME values do not have a month component.
    
    Overrides:
    
    getMonth in class Date
    
    Returns:
    the month represented by this date.
    
    Throws:
    
    IllegalArgumentException - if this method is invoked
    See Also:
    setMonth(int)
  - getDay
```
@Deprecated
public int getDay()
```
    Deprecated.
    
    This method is deprecated and should not be used because SQL TIME values do not have a day component.
    
    Overrides:
    
    getDay in class Date
    
    Returns:
    the day of the week represented by this date.
    
    Throws:
    
    IllegalArgumentException - if this method is invoked
    See Also:
    Calendar
  - getDate
```
@Deprecated
public int getDate()
```
    Deprecated.
    
    This method is deprecated and should not be used because SQL TIME values do not have a date component.
    
    Overrides:
    
    getDate in 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
public void setYear(int i)
```
    Deprecated.
    
    This method is deprecated and should not be used because SQL TIME values do not have a year component.
    
    Overrides:
    
    setYear in class Date
    
    Parameters:
    i - the year value.
    
    Throws:
    
    IllegalArgumentException - if this method is invoked
    See Also:
    getYear()
  - setMonth
```
@Deprecated
public void setMonth(int i)
```
    Deprecated.
    
    This method is deprecated and should not be used because SQL TIME values do not have a month component.
    
    Overrides:
    
    setMonth in class Date
    
    Parameters:
    i - the month value between 0-11.
    
    Throws:
    
    IllegalArgumentException - if this method is invoked
    See Also:
    getMonth()
  - setDate
```
@Deprecated
public void setDate(int i)
```
    Deprecated.
    
    This method is deprecated and should not be used because SQL TIME values do not have a date component.
    
    Overrides:
    
    setDate in class Date
    
    Parameters:
    i - the day of the month value between 1-31.
    
    Throws:
    
    IllegalArgumentException - if this method is invoked
    See Also:
    getDate()

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b138

Class Time

Constructor Summary

Method Summary

Methods inherited from class java.util.Date

Methods inherited from class java.lang.Object

Constructor Detail

Time

Time

Method Detail

setTime

valueOf

toString

getYear

getMonth

getDay

getDate

setYear

setMonth

setDate