Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)

Interfaces
- Array
- Blob
- CallableStatement
- Clob
- Connection
- DatabaseMetaData
- Driver
- NClob
- ParameterMetaData
- PreparedStatement
- Ref
- ResultSet
- ResultSetMetaData
- RowId
- Savepoint
- SQLData
- SQLInput
- SQLOutput
- SQLXML
- Statement
- Struct
- Wrapper
Classes
- Date
- DriverManager
- DriverPropertyInfo
- SQLPermission
- Time
- Timestamp
- Types
Enums
- ClientInfoStatus
- RowIdLifetime
Exceptions

Summary: Ctors | Methods | Inherited Methods | [Expand All]

Added in API level 1

public class

Time

extends Date

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

Class Overview

Java representation of an SQL TIME value. Provides utilities to format and parse the time's representation as a String in JDBC escape format.

Summary

Public Constructors
	Time (int theHour, int theMinute, int theSecond) This constructor was deprecated in API level 1. Use the constructor `Time(long)` instead.
	Time (long theTime) Constructs a `Time` object using a supplied time specified in milliseconds.

Public Methods
int	getDate () This method is deprecated. This method is deprecated and must not be used. An SQL `Time` object does not have a date component.
int	getDay () This method is deprecated. This method is deprecated and must not be used. An SQL `Time` object does not have a day component.
int	getMonth () This method is deprecated. This method is deprecated and must not be used. An SQL `Time` object does not have a month component.
int	getYear () This method is deprecated. This method is deprecated and must not be used. An SQL `Time` object does not have a year component.
void	setDate (int i) This method is deprecated. This method is deprecated and must not be used. An SQL `Time` object does not have a date component.
void	setMonth (int i) This method is deprecated. This method is deprecated and must not be used. An SQL `Time` object does not have a month component.
void	setTime (long time) Sets the time for this `Time` object to the supplied milliseconds value.
void	setYear (int i) This method is deprecated. This method is deprecated and must not be used. An SQL `Time` object does not have a year component.
String	toString () Formats the `Time` as a String in JDBC escape format: `hh:mm:ss` .
static Time	valueOf ( String timeString) Creates a `Time` object from a string holding a time represented in JDBC escape format: `hh:mm:ss` .

[Expand]

Inherited Methods

From class java.util.Date

static long	UTC (int year, int month, int day, int hour, int minute, int second) This method was deprecated in API level 1. Use code like this instead: `Calendar cal = new GregorianCalendar(TimeZone.getTimeZone("GMT")); cal.set(year + 1900, month, day, hour, minute, second); cal.getTime().getTime();`
boolean	after ( Date date) Returns if this `Date` is after the specified Date.
boolean	before ( Date date) Returns if this `Date` is before the specified Date.
Object	clone () Returns a new `Date` with the same millisecond value as this `Date` .
int	compareTo ( Date date) Compare the receiver to the specified `Date` to determine the relative ordering.
boolean	equals ( Object object) Compares the specified object to this `Date` and returns if they are equal.
int	getDate () This method was deprecated in API level 1. Use `Calendar.get(Calendar.DATE)` instead.
int	getDay () This method was deprecated in API level 1. Use `Calendar.get(Calendar.DAY_OF_WEEK)` instead.
int	getHours () This method was deprecated in API level 1. Use `Calendar.get(Calendar.HOUR_OF_DAY)` instead.
int	getMinutes () This method was deprecated in API level 1. Use `Calendar.get(Calendar.MINUTE)` instead.
int	getMonth () This method was deprecated in API level 1. Use `Calendar.get(Calendar.MONTH)` instead.
int	getSeconds () This method was deprecated in API level 1. Use `Calendar.get(Calendar.SECOND)` instead.
long	getTime () Returns this `Date` as a millisecond value.
int	getTimezoneOffset () This method was deprecated in API level 1. Use `(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / 60000` instead.
int	getYear () This method was deprecated in API level 1. Use `Calendar.get(Calendar.YEAR) - 1900` instead.
int	hashCode () Returns an integer hash code for the receiver.
static long	parse ( String string) This method was deprecated in API level 1. Use `DateFormat` instead.
void	setDate (int day) This method was deprecated in API level 1. Use `Calendar.set(Calendar.DATE, day)` instead.
void	setHours (int hour) This method was deprecated in API level 1. Use `Calendar.set(Calendar.HOUR_OF_DAY, hour)` instead.
void	setMinutes (int minute) This method was deprecated in API level 1. Use `Calendar.set(Calendar.MINUTE, minute)` instead.
void	setMonth (int month) This method was deprecated in API level 1. Use `Calendar.set(Calendar.MONTH, month)` instead.
void	setSeconds (int second) This method was deprecated in API level 1. Use `Calendar.set(Calendar.SECOND, second)` instead.
void	setTime (long milliseconds) Sets this `Date` to the specified millisecond value.
void	setYear (int year) This method was deprecated in API level 1. Use `Calendar.set(Calendar.YEAR, year + 1900)` instead.
String	toGMTString () This method was deprecated in API level 1. Use `DateFormat` instead.
String	toLocaleString () This method was deprecated in API level 1. Use `DateFormat` instead.
String	toString () Returns a string representation of this `Date` .

From class java.lang.Object

Object	clone () Creates and returns a copy of this `Object` .
boolean	equals ( Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize () Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class <?>	getClass () Returns the unique instance of `Class` that represents this object's class.
int	hashCode () Returns an integer hash code for this object.
final void	notify () Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll () Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString () Returns a string containing a concise, human-readable description of this object.
final void	wait () Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait (long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait (long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

From interface java.lang.Comparable

Public Constructors

public Time (int theHour, int theMinute, int theSecond)

Added in API level 1

This constructor was deprecated in API level 1.
Use the constructor Time(long) instead.

Constructs a Time object using the supplied values for Hour , Minute and Second . The Year , Month and Day elements of the Time object are set to the date of the Epoch (January 1, 1970).

Any attempt to access the Year , Month or Day elements of a Time object will result in an IllegalArgumentException .

The result is undefined if any argument is out of bounds.

Parameters

theHour	a value in the range `[0,23]` .
theMinute	a value in the range `[0,59]` .
theSecond	a value in the range `[0,59]` .

public Time (long theTime)

Added in API level 1

Constructs a Time object using a supplied time specified in milliseconds.

Parameters

theTime	a `Time` specified in milliseconds since the Epoch (January 1st 1970, 00:00:00.000).

Public Methods

public int getDate ()

Added in API level 1

This method is deprecated.
This method is deprecated and must not be used. An SQL Time object does not have a date component.

Returns the gregorian calendar day of the month for this Date object.

Returns

does not return anything.

Throws

IllegalArgumentException	if this method is called.

public int getDay ()

Added in API level 1

This method is deprecated.
This method is deprecated and must not be used. An SQL Time object does not have a day component.

Returns the gregorian calendar day of the week for this Date object.

Returns

does not return anything.

Throws

IllegalArgumentException	if this method is called.

public int getMonth ()

Added in API level 1

This method is deprecated.
This method is deprecated and must not be used. An SQL Time object does not have a month component.

Returns the gregorian calendar month for this Date object.

Returns

does not return anything.

Throws

IllegalArgumentException	if this method is called.

public int getYear ()

Added in API level 1

This method is deprecated.
This method is deprecated and must not be used. An SQL Time object does not have a year component.

Returns the gregorian calendar year since 1900 for this Date object.

Returns

does not return anything.

Throws

IllegalArgumentException	if this method is called.

public void setDate (int i)

Added in API level 1

This method is deprecated.
This method is deprecated and must not be used. An SQL Time object does not have a date component.

Sets the gregorian calendar day of the month for this Date object.

Parameters

i	the day of the month.

Throws

IllegalArgumentException	if this method is called.

public void setMonth (int i)

Added in API level 1

This method is deprecated.
This method is deprecated and must not be used. An SQL Time object does not have a month component.

Sets the gregorian calendar month for this Date object.

Parameters

i	the month.

Throws

IllegalArgumentException	if this method is called.

public void setTime (long time)

Added in API level 1

Sets the time for this Time object to the supplied milliseconds value.

Parameters

time	A time value expressed as milliseconds since the Epoch . Negative values are milliseconds before the Epoch. The Epoch is January 1 1970, 00:00:00.000.

public void setYear (int i)

Added in API level 1

This method is deprecated.
This method is deprecated and must not be used. An SQL Time object does not have a year component.

Sets the gregorian calendar year since 1900 for this Date object.

Parameters

i	the year since 1900.

Throws

IllegalArgumentException	if this method is called.

public String toString ()

Added in API level 1

Formats the Time as a String in JDBC escape format: hh:mm:ss .

Returns

A String representing the Time value in JDBC escape format: HH:mm:ss

public static Time valueOf ( String timeString)

Added in API level 1

Creates a Time object from a string holding a time represented in JDBC escape format: hh:mm:ss .

An exception occurs if the input string does not comply with this format.

Parameters

timeString	A String representing the time value in JDBC escape format: `hh:mm:ss` .

Returns

The Time object set to a time corresponding to the given time.

Throws

IllegalArgumentException	if the supplied time string is not in JDBC escape format.

Results

Interfaces

Classes

Enums

Exceptions

Time

Class Overview

Summary

Public Constructors

public Time (int theHour, int theMinute, int theSecond)

Parameters

public Time (long theTime)

Parameters

Public Methods

public int getDate ()

Returns

Throws

public int getDay ()

Returns

Throws

public int getMonth ()

Returns

Throws

public int getYear ()

Returns

Throws

public void setDate (int i)

Parameters

Throws

public void setMonth (int i)

Parameters

Throws

public void setTime (long time)

Parameters

public void setYear (int i)

Parameters

Throws

public String toString ()

Returns

public static Time valueOf ( String timeString)

Parameters

Returns

Throws