Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)

Interfaces
- Array
- Blob
- CallableStatement
- Clob
- Connection
- DatabaseMetaData
- Driver
- NClob
- ParameterMetaData
- PreparedStatement
- Ref
- ResultSet
- ResultSetMetaData
- RowId
- Savepoint
- SQLData
- SQLInput
- SQLOutput
- SQLXML
- Statement
- Struct
- Wrapper
Classes
- Date
- DriverManager
- DriverPropertyInfo
- SQLPermission
- Time
- Timestamp
- Types
Enums
- ClientInfoStatus
- RowIdLifetime
Exceptions

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

Added in API level 1

public class

Date

extends Date

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

Class Overview

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.

Summary

Public Constructors
	Date (int theYear, int theMonth, int theDay) This constructor was deprecated in API level 1. 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` .

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 was deprecated in API level 1. Use code like this instead: `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) Returns if this `Date` is before the specified Date.
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 returns if they are equal.
int	getDate () This method was deprecated in API level 1. Use `Calendar.get(Calendar.DATE)` instead.
int	getDay () This method was deprecated in API level 1. Use `Calendar.get(Calendar.DAY_OF_WEEK)` instead.
int	getHours () This method was deprecated in API level 1. Use `Calendar.get(Calendar.HOUR_OF_DAY)` instead.
int	getMinutes () This method was deprecated in API level 1. Use `Calendar.get(Calendar.MINUTE)` instead.
int	getMonth () This method was deprecated in API level 1. Use `Calendar.get(Calendar.MONTH)` instead.
int	getSeconds () This method was deprecated in API level 1. Use `Calendar.get(Calendar.SECOND)` instead.
long	getTime () Returns this `Date` as a millisecond value.
int	getTimezoneOffset () This method was deprecated in API level 1. Use `(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / 60000` instead.
int	getYear () This method was deprecated in API level 1. Use `Calendar.get(Calendar.YEAR) - 1900` instead.
int	hashCode () Returns an integer hash code for the receiver.
static long	parse ( String string) This method was deprecated in API level 1. Use `DateFormat` instead.
void	setDate (int day) This method was deprecated in API level 1. Use `Calendar.set(Calendar.DATE, day)` instead.
void	setHours (int hour) This method was deprecated in API level 1. Use `Calendar.set(Calendar.HOUR_OF_DAY, hour)` instead.
void	setMinutes (int minute) This method was deprecated in API level 1. Use `Calendar.set(Calendar.MINUTE, minute)` instead.
void	setMonth (int month) This method was deprecated in API level 1. Use `Calendar.set(Calendar.MONTH, month)` instead.
void	setSeconds (int second) This method was deprecated in API level 1. Use `Calendar.set(Calendar.SECOND, second)` instead.
void	setTime (long milliseconds) Sets this `Date` to the specified millisecond value.
void	setYear (int year) This method was deprecated in API level 1. Use `Calendar.set(Calendar.YEAR, year + 1900)` instead.
String	toGMTString () This method was deprecated in API level 1. Use `DateFormat` instead.
String	toLocaleString () This method was deprecated in API level 1. Use `DateFormat` instead.
String	toString () Returns a string representation of this `Date` .

From class java.lang.Object

Object	clone () Creates and returns a copy of this `Object` .
boolean	equals ( Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize () Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class <?>	getClass () Returns the unique instance of `Class` that represents this object's class.
int	hashCode () Returns an integer hash code for this object.
final void	notify () Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll () Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString () Returns a string containing a concise, human-readable description of this object.
final void	wait () Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait (long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait (long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

From interface java.lang.Comparable

Public Constructors

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

Added in API level 1

This constructor was deprecated in API level 1.
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]` .

public Date (long theDate)

Added in API level 1

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.

Public Methods

public int getHours ()

Added in API level 1

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

Throws

IllegalArgumentException	if this method is called.

public int getMinutes ()

Added in API level 1

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

Throws

IllegalArgumentException	if this method is called.

public int getSeconds ()

Added in API level 1

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

Throws

IllegalArgumentException	if this method is called.

public void setHours (int theHours)

Added in API level 1

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)

Added in API level 1

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)

Added in API level 1

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)

Added in API level 1

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.

Parameters

theTime	the time in milliseconds since the Epoch.

public String toString ()

Added in API level 1

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)

Added in API level 1

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.

Results

Interfaces

Classes

Enums

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