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 is deprecated. Use the constructor Date(long).
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
From class java.lang.Object
From interface java.lang.Comparable

Public Constructors

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

Since: API Level 1

This constructor is deprecated.
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,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)

Since: 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 ()

Since: 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 ()

Since: 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 ()

Since: 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)

Since: 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)

Since: 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)

Since: 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)

Since: 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 ()

Since: 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)

Since: 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.