Android
java.sql
public class

java.sql.Date

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

A Date class which can consume and produce dates in SQL Date format.

The SQL date format represents a date as yyyy-mm-dd. Note that this date format only deals with year, month and day values. There are no values for hours, minutes, seconds.

This contrasts with regular java.util.Date values, which include time values for hours, minutes, seconds, milliseconds.

Time points are handled as millisecond values - milliseconds since the epoch, January 1st 1970, 00:00:00.000 GMT. Time values passed to the java.sql.Date class are "normalized" to the time 00:00:00.000 GMT on the date implied by the time value.

Summary

Public Constructors

            Date(int theYear, int theMonth, int theDay)
This constructor is deprecated. Please use the constructor Date(long) Constructs a Date object corresponding to the supplied Year, Month and Day.
            Date(long theDate)
Creates a Date which corresponds to the day implied by the supplied theDate milliseconds time value.

Public Methods

          int  getHours()
This method is deprecated. This method is deprecated and must not be used. SQL Date values do not have an hours component.
          int  getMinutes()
This method is deprecated. This method is deprecated and must not be used. SQL Date values do not have a minutes component.
          int  getSeconds()
This method is deprecated. This method is deprecated and must not be used. SQL Date values do not have a seconds component.
          void  setHours(int theHours)
This method is deprecated. This method is deprecated and must not be used. SQL Date values do not have an hours component.
          void  setMinutes(int theMinutes)
This method is deprecated. This method is deprecated and must not be used. SQL Date values do not have a minutes component.
          void  setSeconds(int theSeconds)
This method is deprecated. This method is deprecated and must not be used. SQL Date values do not have a seconds component.
          void  setTime(long theTime)
Sets this date to a date supplied as a milliseconds value.
          String  toString()
Produces a string representation of the Date in SQL format
      static    Date  valueOf(String dateString)
Creates a Date from a string representation of a date in SQL format.
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 Date(int theYear, int theMonth, int theDay)

This constructor is deprecated. Please use the constructor Date(long) Constructs a Date object corresponding to the supplied Year, Month and Day.

Parameters

theYear the year, specified as the year minus 1900. Must be in the range 0 to 8099.
theMonth the month, specified as a number with 0 = January. Must be in the range 0 to 11.
theDay the day in the month. Must be in the range 1 to 31.

public Date(long theDate)

Creates a Date which corresponds to the day implied by the supplied theDate milliseconds time value.

Parameters

theDate - a time value in milliseconds since the epoch - January 1 1970 00:00:00 GMT. The time value (hours, minutes, seconds, milliseconds) stored in the Date object is adjusted to correspond to 00:00:00 GMT on the day implied by the supplied time value.

Public Methods

public int getHours()

This method is deprecated. This method is deprecated and must not be used. SQL Date values do not have an hours component.

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

Returns

  • does not return

Throws

IllegalArgumentException if this method is called

public int getMinutes()

This method is deprecated. This method is deprecated and must not be used. SQL Date values do not have a minutes component.

Returns the gregorian calendar minute of the hour for this Date object.

Returns

  • does not return

Throws

IllegalArgumentException if this method is called

public int getSeconds()

This method is deprecated. This method is deprecated and must not be used. SQL Date values do not have a seconds component.

Returns the gregorian calendar second of the minute for this Date object.

Returns

  • does not return

Throws

IllegalArgumentException if this method is called

public void setHours(int theHours)

This method is deprecated. This method is deprecated and must not be used. SQL Date values do not have an hours component.

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

Parameters

theHours the number of hours to set

Throws

IllegalArgumentException if this method is called

public void setMinutes(int theMinutes)

This method is deprecated. This method is deprecated and must not be used. SQL Date values do not have a minutes component.

Sets the gregorian calendar minute of the hour for this Date object.

Parameters

theMinutes the number of minutes to set

Throws

IllegalArgumentException if this method is called

public void setSeconds(int theSeconds)

This method is deprecated. This method is deprecated and must not be used. SQL Date values do not have a seconds component.

Sets the gregorian calendar second of the minute for this Date object.

Parameters

theSeconds the number of seconds to set

Throws

IllegalArgumentException if this method is called

public void setTime(long theTime)

Sets this date to a date supplied as a milliseconds value. The date is set based on the supplied time value after removing any time elements finer than a day, based on zero GMT for that day.

Parameters

theTime the time in milliseconds since the Epoch

public String toString()

Produces a string representation of the Date in SQL format

Returns

  • a string representation of the Date in SQL format - "yyyy-mm-dd".

public static Date valueOf(String dateString)

Creates a Date from a string representation of a date in SQL format.

Parameters

dateString the string representation of a date in SQL format - "yyyy-mm-dd".

Returns

  • the Date object

Throws

IllegalArgumentException if the format of the supplied string does not match the SQL format.
Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:56