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 class which can consume and produce dates in SQL Date format.

Dates are represented in SQL 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 is unlike the familiar java.util.Date object, which also includes values for hours, minutes, seconds, and 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

Constructors

Constructor and Description
Date(int theYear, int theMonth, int theDay) Deprecated. Use the constructor Date(long) instead.
Date(long theDate) Creates a date which corresponds to the day determined by the supplied milliseconds time value theDate.

Method Summary

Modifier and Type	Method and Description
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, from, getDate, getDay, getMonth, getTime, getTimezoneOffset, getYear, hashCode, parse, setDate, setMonth, setYear, toGMTString, toInstant, 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. Use the constructor Date(long) instead.

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

theMonth - the month, specified as a number with 0 = January. Must be in the range [0,11].

theDay - the day in the month. Must be in the range [1,31].

Date

public Date(long theDate)

Creates a date which corresponds to the day determined by the supplied milliseconds time value theDate.

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 determined 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 anything.

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

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

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 and rounded to 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.