java.sql
Class Date

java.lang.Object
  java.util.Date
      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.