Android
java.sql
public class

java.sql.Time

java.lang.Object
java.util.Date Serializable Cloneable Comparable<T>
java.sql.Time

Java representation of an SQL TIME value. Provides functions to aid generation and interpretation of JDBC escape format for time values.

Summary

Public Constructors

            Time(int theHour, int theMinute, int theSecond)
This constructor is 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 1970, January, 1 reflecting the Epoch (Time in milliseconds = 0).

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

Result is undefined if any argument is out of bounds.

            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.
Methods inherited from class java.util.Date
Methods inherited from class java.lang.Object
Methods inherited from interface java.lang.Comparable

Details

Public Constructors

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

This constructor is 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 1970, January, 1 reflecting the Epoch (Time in milliseconds = 0).

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

Result is undefined if any argument is out of bounds.

Parameters

theHour a value from 0 - 23
theMinute a value from 0 - 59
theSecond a value from 0 - 59

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)

Public Methods

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

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

Returns

  • does not return

Throws

IllegalArgumentException if this method is called

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

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

Returns

  • does not return

Throws

IllegalArgumentException if this method is called

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

Returns the gregorian calendar month for this Date object.

Returns

  • does not return

Throws

IllegalArgumentException if this method is called

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

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

Returns

  • does not return

Throws

IllegalArgumentException if this method is called

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

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)

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)

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)

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

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)

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 is not in the form of a time in JDBC escape 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.
Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:48