java.util
Class Date

java.lang.Object
  java.util.Date

All Implemented Interfaces:

Serializable, Cloneable, Comparable

Direct Known Subclasses:

Date, Time, Timestamp

public class Date
extends Object
implements Serializable, Cloneable, Comparable

Date represents a specific moment in time, to the millisecond.

See Also:

System.currentTimeMillis(), Calendar, GregorianCalendar, SimpleTimeZone, TimeZone, Serialized Form

Constructor Summary

Date()
Initializes this Date instance to the current date and time.

Date(int year, int month, int day)
Deprecated. use GregorianCalendar(int, int, int)

Date(int year, int month, int day, int hour, int minute)
Deprecated. use GregorianCalendar(int, int, int, int, int)

Date(int year, int month, int day, int hour, int minute, int second)
Deprecated. use GregorianCalendar(int, int, int, int, int, int)

Date(long milliseconds)
Initializes this Date instance using the specified millisecond value.

Date(String string)
Deprecated. use DateFormat

Method Summary

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

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Date

public Date()

Initializes this Date instance to the current date and time.

Date

public Date(int year,
            int month,
            int day)

Deprecated. use GregorianCalendar(int, int, int)

Constructs a new Date initialized to midnight in the default TimeZone on the specified date.

Parameters:

year - the year, 0 is 1900

month - the month, 0 - 11

day - the day of the month, 1 - 31

Date

public Date(int year,
            int month,
            int day,
            int hour,
            int minute)

Deprecated. use GregorianCalendar(int, int, int, int, int)

Constructs a new Date initialized to the specified date and time in the default TimeZone.

Parameters:

year - the year, 0 is 1900

month - the month, 0 - 11

day - the day of the month, 1 - 31

hour - the hour of day, 0 - 23

minute - the minute of the hour, 0 - 59

Date

public Date(int year,
            int month,
            int day,
            int hour,
            int minute,
            int second)

Deprecated. use GregorianCalendar(int, int, int, int, int, int)

Constructs a new Date initialized to the specified date and time in the default TimeZone.

Parameters:

year - the year, 0 is 1900

month - the month, 0 - 11

day - the day of the month, 1 - 31

hour - the hour of day, 0 - 23

minute - the minute of the hour, 0 - 59

second - the second of the minute, 0 - 59

Date

public Date(long milliseconds)

Initializes this Date instance using the specified millisecond value. The value is the number of milliseconds since Jan. 1, 1970 GMT.

Parameters:

milliseconds - the number of milliseconds since Jan. 1, 1970 GMT

Date

public Date(String string)

Deprecated. use DateFormat

Constructs a new Date initialized to the date and time parsed from the specified String.

Parameters:

string - the String to parse

Method Detail

after

public boolean after(Date date)

Answers if this Date is after the specified Date.

Parameters:

date - a Date instance to compare

Returns:

true if this Date is after the specified Date, false otherwise

before

public boolean before(Date date)

Answers if this Date is before the specified Date.

Parameters:

date - a Date instance to compare

Returns:

true if this Date is before the specified Date, false otherwise

clone

public Object clone()

Answers a new Date with the same millisecond value as this Date.

Overrides:

clone in class Object

Returns:

a shallow copy of this Date

See Also:

Cloneable

compareTo

public int compareTo(Object object)

Compare the receiver to the specified Object to determine the relative ordering.

Specified by:

compareTo in interface Comparable

Parameters:

object - an Object

Returns:

an int < 0 if this Date is less than the specified Date, 0 if they are equal, and > 0 if this Date is greater

Throws:

ClassCastException - when object is not a Date

compareTo

public int compareTo(Date date)

Compare the receiver to the specified Date to determine the relative ordering.

Parameters:

date - a Date

Returns:

an int < 0 if this Date is less than the specified Date, 0 if they are equal, and > 0 if this Date is greater

equals

public boolean equals(Object object)

Compares the specified object to this Date and answer if they are equal. The object must be an instance of Date and have the same millisecond value.

Overrides:

equals in class Object

Parameters:

object - the object to compare with this object

Returns:

true if the specified object is equal to this Date, false otherwise

See Also:

hashCode()

getDate

public int getDate()

Deprecated. use Calendar.get(Calendar.DATE)

Answers the gregorian calendar day of the month for this Date object.

Returns:

the day of the month

getDay

public int getDay()

Deprecated. use Calendar.get(Calendar.DAY_OF_WEEK)

Answers the gregorian calendar day of the week for this Date object.

Returns:

the day of the week

getHours

public int getHours()

Deprecated. use Calendar.get(Calendar.HOUR_OF_DAY)

Answers the gregorian calendar hour of the day for this Date object.

Returns:

the hour of the day

getMinutes

public int getMinutes()

Deprecated. use Calendar.get(Calendar.MINUTE)

Answers the gregorian calendar minute of the hour for this Date object.

Returns:

the minutes

getMonth

public int getMonth()

Deprecated. use Calendar.get(Calendar.MONTH)

Answers the gregorian calendar month for this Date object.

Returns:

the month

getSeconds

public int getSeconds()

Deprecated. use Calendar.get(Calendar.SECOND)

Answers the gregorian calendar second of the minute for this Date object.

Returns:

the seconds

getTime

public long getTime()

Answers this Date as a millisecond value. The value is the number of milliseconds since Jan. 1, 1970 GMT.

Returns:

the number of milliseconds since Jan. 1, 1970 GMT.

getTimezoneOffset

public int getTimezoneOffset()

Deprecated. use (Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / 60000

Answers the timezone offset in minutes of the default TimeZone.

Returns:

the timezone offset in minutes of the default TimeZone

getYear

public int getYear()

Deprecated. use Calendar.get(Calendar.YEAR) - 1900

Answers the gregorian calendar year since 1900 for this Date object.

Returns:

the year - 1900

hashCode

public int hashCode()

Answers an integer hash code for the receiver. Objects which are equal answer the same value for this method.

Overrides:

hashCode in class Object

Returns:

the receiver's hash

See Also:

equals(java.lang.Object)

parse

public static long parse(String string)

Deprecated. use DateFormat

Answers the millisecond value of the date and time parsed from the specified String. Many date/time formats are recognized, including IETF standard syntax, i.e. Tue, 22 Jun 1999 12:16:00 GMT-0500

Parameters:

string - the String to parse

Returns:

the millisecond value parsed from the String

setDate

public void setDate(int day)

Deprecated. use Calendar.set(Calendar.DATE, day)

Sets the gregorian calendar day of the month for this Date object.

Parameters:

day - the day of the month

setHours

public void setHours(int hour)

Deprecated. use Calendar.set(Calendar.HOUR_OF_DAY, hour)

Sets the gregorian calendar hour of the day for this Date object.

Parameters:

hour - the hour of the day

setMinutes

public void setMinutes(int minute)

Deprecated. use Calendar.set(Calendar.MINUTE, minute)

Sets the gregorian calendar minute of the hour for this Date object.

Parameters:

minute - the minutes

setMonth

public void setMonth(int month)

Deprecated. use Calendar.set(Calendar.MONTH, month)

Sets the gregorian calendar month for this Date object.

Parameters:

month - the month

setSeconds

public void setSeconds(int second)

Deprecated. use Calendar.set(Calendar.SECOND, second)

Sets the gregorian calendar second of the minute for this Date object.

Parameters:

second - the seconds

setTime

public void setTime(long milliseconds)

Sets this Date to the specified millisecond value. The value is the number of milliseconds since Jan. 1, 1970 GMT.

Parameters:

milliseconds - the number of milliseconds since Jan. 1, 1970 GMT.

setYear

public void setYear(int year)

Deprecated. use Calendar.set(Calendar.YEAR, year + 1900)

Sets the gregorian calendar year since 1900 for this Date object.

Parameters:

year - the year since 1900

toGMTString

public String toGMTString()

Deprecated. use DateFormat

Answers the string representation of this Date in GMT in the format: 22 Jun 1999 13:02:00 GMT

Returns:

the string representation of this Date in GMT

toLocaleString

public String toLocaleString()

Deprecated. use DateFormat

Answers the string representation of this Date for the current Locale.

Returns:

the string representation of this Date for the current Locale

toString

public String toString()

Answers the string representation of this Date in the format: Tue Jun 22 13:07:00 GMT 1999

Overrides:

toString in class Object

Returns:

the string representation of this Date

UTC

public static long UTC(int year,
                       int month,
                       int day,
                       int hour,
                       int minute,
                       int second)

Deprecated. use: Calendar cal = new GregorianCalendar(TimeZone.getTimeZone("GMT")); cal.set(year + 1900, month, day, hour, minute, second); cal.getTime().getTime();

Answers the millisecond value of the specified date and time in GMT.

Parameters:

year - the year, 0 is 1900

month - the month, 0 - 11

day - the day of the month, 1 - 31

hour - the hour of day, 0 - 23

minute - the minute of the hour, 0 - 59

second - the second of the minute, 0 - 59