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

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

Since:

Android 1.0

See Also:

Serialized Form

Constructor Summary

Time(int theHour, int theMinute, int theSecond)
Deprecated. Please use the constructor Time(long).

Time(long theTime)
Constructs a Time object using a supplied time specified in milliseconds.

Method Summary

int	getDate() Deprecated. This method is deprecated and must not be used. An SQL Time object does not have a Date component.
int	getDay() Deprecated. This method is deprecated and must not be used. An SQL Time object does not have a Day component.
int	getMonth() Deprecated. This method is deprecated and must not be used. An SQL Time object does not have a Month component.
int	getYear() Deprecated. This method is deprecated and must not be used. An SQL Time object does not have a Year component.
void	setDate(int i) Deprecated. This method is deprecated and must not be used. An SQL Time object does not have a Date component.
void	setMonth(int i) 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) 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.

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 theHour,
                       int theMinute,
                       int theSecond)

Deprecated. Please use the constructor Time(long).

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].

Since:

Android 1.0

Time

public Time(long theTime)

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).

Since:

Android 1.0

Method Detail

getDate

@Deprecated
public int getDate()

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

Description copied from class: Date

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

Overrides:

getDate in class Date

Returns:

does not return anything.

Throws:

IllegalArgumentException - if this method is called.

Since:

Android 1.0

getDay

@Deprecated
public int getDay()

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

Description copied from class: Date

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

Overrides:

getDay in class Date

Returns:

does not return anything.

Throws:

IllegalArgumentException - if this method is called.

Since:

Android 1.0

getMonth

@Deprecated
public int getMonth()

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

Description copied from class: Date

Returns the gregorian calendar month for this Date object.

Overrides:

getMonth in class Date

Returns:

does not return anything.

Throws:

IllegalArgumentException - if this method is called.

Since:

Android 1.0

getYear

@Deprecated
public int getYear()

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

Description copied from class: Date

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

Overrides:

getYear in class Date

Returns:

does not return anything.

Throws:

IllegalArgumentException - if this method is called.

Since:

Android 1.0

setDate

@Deprecated
public void setDate(int i)

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

Description copied from class: Date

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

Overrides:

setDate in class Date

Parameters:

i - the day of the month.

Throws:

IllegalArgumentException - if this method is called.

Since:

Android 1.0

setMonth

@Deprecated
public void setMonth(int i)

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

Description copied from class: Date

Sets the gregorian calendar month for this Date object.

Overrides:

setMonth in class Date

Parameters:

i - the month.

Throws:

IllegalArgumentException - if this method is called.

Since:

Android 1.0

setYear

@Deprecated
public void setYear(int i)

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

Description copied from class: Date

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

Overrides:

setYear in class Date

Parameters:

i - the year since 1900.

Throws:

IllegalArgumentException - if this method is called.

setTime

public void setTime(long time)

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

Overrides:

setTime in class Date

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.

Since:

Android 1.0

toString

public String toString()

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

Overrides:

toString in class Date

Returns:

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

Since:

Android 1.0

valueOf

public static Time valueOf(String timeString)

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.

Since:

Android 1.0