Build 1.0_r1(from source)

java.sql
Class Date

java.lang.Object
  extended by java.util.Date
      extended by java.sql.Date
All Implemented Interfaces:
Serializable, Cloneable, Comparable<Date>

public class Date
extends 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.

See Also:
Serialized Form

Constructor Summary
Date(int theYear, int theMonth, int theDay)
          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.
 
Method Summary
 int getHours()
          Deprecated. This method is deprecated and must not be used. SQL Date values do not have an hours component.
 int getMinutes()
          Deprecated. This method is deprecated and must not be used. SQL Date values do not have a minutes component.
 int getSeconds()
          Deprecated. This method is deprecated and must not be used. SQL Date values do not have a seconds component.
 void setHours(int theHours)
          Deprecated. This method is deprecated and must not be used. SQL Date values do not have an hours component.
 void setMinutes(int theMinutes)
          Deprecated. This method is deprecated and must not be used. SQL Date values do not have a minutes component.
 void setSeconds(int theSeconds)
          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
after, before, clone, compareTo, equals, getDate, getDay, getMonth, getTime, getTimezoneOffset, getYear, hashCode, parse, setDate, setMonth, setYear, toGMTString, toLocaleString, UTC
 
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

Date

@Deprecated
public Date(int theYear,
                       int theMonth,
                       int theDay)
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.

Date

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.
Method Detail

getHours

@Deprecated
public int getHours()
Deprecated. This method is deprecated and must not be used. SQL Date values do not have an hours component.

Description copied from class: Date
Returns the gregorian calendar hour of the day for this Date object.

Overrides:
getHours in class Date
Returns:
does not return
Throws:
IllegalArgumentException - if this method is called

getMinutes

@Deprecated
public int getMinutes()
Deprecated. This method is deprecated and must not be used. SQL Date values do not have a minutes component.

Description copied from class: Date
Returns the gregorian calendar minute of the hour for this Date object.

Overrides:
getMinutes in class Date
Returns:
does not return
Throws:
IllegalArgumentException - if this method is called

getSeconds

@Deprecated
public int getSeconds()
Deprecated. This method is deprecated and must not be used. SQL Date values do not have a seconds component.

Description copied from class: Date
Returns the gregorian calendar second of the minute for this Date object.

Overrides:
getSeconds in class Date
Returns:
does not return
Throws:
IllegalArgumentException - if this method is called

setHours

@Deprecated
public void setHours(int theHours)
Deprecated. This method is deprecated and must not be used. SQL Date values do not have an hours component.

Description copied from class: Date
Sets the gregorian calendar hour of the day for this Date object.

Overrides:
setHours in class Date
Parameters:
theHours - the number of hours to set
Throws:
IllegalArgumentException - if this method is called

setMinutes

@Deprecated
public void setMinutes(int theMinutes)
Deprecated. This method is deprecated and must not be used. SQL Date values do not have a minutes component.

Description copied from class: Date
Sets the gregorian calendar minute of the hour for this Date object.

Overrides:
setMinutes in class Date
Parameters:
theMinutes - the number of minutes to set
Throws:
IllegalArgumentException - if this method is called

setSeconds

@Deprecated
public void setSeconds(int theSeconds)
Deprecated. This method is deprecated and must not be used. SQL Date values do not have a seconds component.

Description copied from class: Date
Sets the gregorian calendar second of the minute for this Date object.

Overrides:
setSeconds in class Date
Parameters:
theSeconds - the number of seconds to set
Throws:
IllegalArgumentException - if this method is called

setTime

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.

Overrides:
setTime in class Date
Parameters:
theTime - the time in milliseconds since the Epoch

toString

public String toString()
Produces a string representation of the Date in SQL format

Overrides:
toString in class Date
Returns:
a string representation of the Date in SQL format - "yyyy-mm-dd".

valueOf

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.

Build 1.0_r1(from source)

Please submit a feedback, bug or feature