Summary: Ctors | Methods | Inherited Methods | [Expand All]

public class

Date

extends Date

java.lang.Object
↳	java.util.Date
	↳	java.sql.Date

Class Overview

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.

[Expand]

Inherited Methods

From class java.util.Date

static long	UTC(int year, int month, int day, int hour, int minute, int second) This method is deprecated. use: `Calendar cal = new GregorianCalendar(TimeZone.getTimeZone("GMT")); cal.set(year + 1900, month, day, hour, minute, second); cal.getTime().getTime();`
boolean	after(Date date) Returns if this Date is after the specified Date.
boolean	before(Date date) Boolean indication of whether or not this `Date` occurs earlier than the `Date` argument.
Object	clone() Returns a new Date with the same millisecond value as this Date.
int	compareTo(Date date) Compare the receiver to the specified Date to determine the relative ordering.
boolean	equals(Object object) Compares the specified object to this Date and answer if they are equal.
int	getDate() This method is deprecated. use Calendar.get(Calendar.DATE)
int	getDay() This method is deprecated. use Calendar.get(Calendar.DAY_OF_WEEK)
int	getHours() This method is deprecated. use Calendar.get(Calendar.HOUR_OF_DAY)
int	getMinutes() This method is deprecated. use Calendar.get(Calendar.MINUTE)
int	getMonth() This method is deprecated. use Calendar.get(Calendar.MONTH)
int	getSeconds() This method is deprecated. use Calendar.get(Calendar.SECOND)
long	getTime() Returns this Date as a millisecond value.
int	getTimezoneOffset() This method is deprecated. use `(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / 60000`
int	getYear() This method is deprecated. use `Calendar.get(Calendar.YEAR) - 1900`
int	hashCode() Returns an integer hash code for the receiver.
static long	parse(String string) This method is deprecated. use DateFormat
void	setDate(int day) This method is deprecated. use Calendar.set(Calendar.DATE, day)
void	setHours(int hour) This method is deprecated. use Calendar.set(Calendar.HOUR_OF_DAY, hour)
void	setMinutes(int minute) This method is deprecated. use Calendar.set(Calendar.MINUTE, minute)
void	setMonth(int month) This method is deprecated. use Calendar.set(Calendar.MONTH, month)
void	setSeconds(int second) This method is deprecated. use Calendar.set(Calendar.SECOND, second)
void	setTime(long milliseconds) Sets this Date to the specified millisecond value.
void	setYear(int year) This method is deprecated. use Calendar.set(Calendar.YEAR, year + 1900)
String	toGMTString() This method is deprecated. use DateFormat
String	toLocaleString() This method is deprecated. use DateFormat
String	toString() Returns the string representation of this Date in the format: Tue Jun 22 13:07:00 GMT 1999

From class java.lang.Object

Object	clone() Returns a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
boolean	equals(Object o) Compares the argument to the receiver, and returns true if they represent the same object using a class specific comparison.
void	finalize() Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
final Class<? extends Object>	getClass() Returns the unique instance of java.lang.Class which represents the class of the receiver.
int	hashCode() Returns an integer hash code for the receiver.
final void	notify() Causes one thread which is `wait` ing on the receiver to be made ready to run.
final void	notifyAll() Causes all threads which are `wait` ing on the receiver to be made ready to run.
String	toString() Returns a string containing a concise, human-readable description of the receiver.
final void	wait(long time, int frac) Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final void	wait(long time) Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final void	wait() Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by `notify` or `notifyAll`).

From interface java.lang.Comparable

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.

Jan	FEB	Mar
	18
2008	2009	2010

Interfaces

Classes

Exceptions

Date

Class Overview

Summary

Public Constructors

public Date (int theYear, int theMonth, int theDay)

Parameters

public Date (long theDate)

Parameters

Public Methods

public int getHours ()

Returns

Throws

public int getMinutes ()

Returns

Throws

public int getSeconds ()

Returns

Throws

public void setHours (int theHours)

Parameters

Throws

public void setMinutes (int theMinutes)

Parameters

Throws

public void setSeconds (int theSeconds)

Parameters

Throws

public void setTime (long theTime)

Parameters

public String toString ()

Returns

public static Date valueOf (String dateString)

Parameters

Returns

Throws