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

public class

Date

extends Object
implements Serializable Cloneable Comparable<T>

java.lang.Object
↳	java.util.Date

Known Direct Subclasses

Date, Time, Timestamp

Class Overview

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

Summary

Public Constructors
	Date() Initializes this Date instance to the current date and time.
	Date(int year, int month, int day) This constructor is deprecated. use GregorianCalendar(int, int, int)
	Date(int year, int month, int day, int hour, int minute) This constructor is deprecated. use GregorianCalendar(int, int, int, int, int)
	Date(int year, int month, int day, int hour, int minute, int second) This constructor is deprecated. use GregorianCalendar(int, int, int, int, int, int)
	Date(long milliseconds) Initializes this Date instance using the specified millisecond value.
	Date(String string) This constructor is deprecated. use DateFormat

Public Methods
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

[Expand]

Inherited Methods

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

Initializes this Date instance to the current date and time.

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

This constructor is 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

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

This constructor is 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

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

This constructor is 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

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

public Date (String string)

This constructor is deprecated. use DateFormat

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

Parameters

string	the String to parse

Public Methods

public 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();

Returns 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

Returns

long

public boolean after (Date date)

Returns 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

public boolean before (Date date)

Boolean indication of whether or not this Date occurs earlier than the Date argument.

Parameters

date	a Date instance to compare

Returns

true if this Date occurs earlier than date, otherwise false

public Object clone ()

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

Returns

a shallow copy of this Date

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

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.

Parameters

object	the object to compare with this object

Returns

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

public int getDate ()

This method is deprecated. use Calendar.get(Calendar.DATE)

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

Returns

the day of the month

public int getDay ()

This method is deprecated. use Calendar.get(Calendar.DAY_OF_WEEK)

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

Returns

the day of the week

public int getHours ()

This method is deprecated. use Calendar.get(Calendar.HOUR_OF_DAY)

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

Returns

the hour of the day

public int getMinutes ()

This method is deprecated. use Calendar.get(Calendar.MINUTE)

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

Returns

the minutes

public int getMonth ()

This method is deprecated. use Calendar.get(Calendar.MONTH)

Returns the gregorian calendar month for this Date object.

Returns

the month

public int getSeconds ()

This method is deprecated. use Calendar.get(Calendar.SECOND)

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

Returns

the seconds

public long getTime ()

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

public int getTimezoneOffset ()

This method is deprecated. use (Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / 60000

Returns the timezone offset in minutes of the default TimeZone.

Returns

the timezone offset in minutes of the default TimeZone

public int getYear ()

This method is deprecated. use Calendar.get(Calendar.YEAR) - 1900

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

Returns

the year - 1900

public int hashCode ()

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

Returns

the receiver's hash

public static long parse (String string)

This method is deprecated. use DateFormat

Returns 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

public void setDate (int day)

This method is 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

public void setHours (int hour)

This method is 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

public void setMinutes (int minute)

This method is deprecated. use Calendar.set(Calendar.MINUTE, minute)

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

Parameters

minute	the minutes

public void setMonth (int month)

This method is deprecated. use Calendar.set(Calendar.MONTH, month)

Sets the gregorian calendar month for this Date object.

Parameters

month	the month

public void setSeconds (int second)

This method is deprecated. use Calendar.set(Calendar.SECOND, second)

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

Parameters

second	the seconds

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.

public void setYear (int year)

This method is 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

public String toGMTString ()

This method is deprecated. use DateFormat

Returns 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

public String toLocaleString ()

This method is deprecated. use DateFormat

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

Returns

the string representation of this Date for the current Locale

public String toString ()

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

Returns

the string representation of this Date

Jan	FEB	Mar
	15
2008	2009	2010

Interfaces

Classes

Enums

Exceptions

Date

Class Overview

See Also

Summary

Public Constructors

public Date ()

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

Parameters

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

Parameters

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

Parameters

public Date (long milliseconds)

Parameters

public Date (String string)

Parameters

Public Methods

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

Parameters

Returns

public boolean after (Date date)

Parameters

Returns

public boolean before (Date date)

Parameters

Returns

public Object clone ()

Returns

See Also

public int compareTo (Date date)

Parameters

Returns

public boolean equals (Object object)

Parameters

Returns

See Also

public int getDate ()

Returns

public int getDay ()

Returns

public int getHours ()

Returns

public int getMinutes ()

Returns

public int getMonth ()

Returns

public int getSeconds ()

Returns

public long getTime ()

Returns

public int getTimezoneOffset ()

Returns

public int getYear ()

Returns

public int hashCode ()

Returns

See Also

public static long parse (String string)

Parameters

Returns

public void setDate (int day)

Parameters

public void setHours (int hour)

Parameters

public void setMinutes (int minute)

Parameters

public void setMonth (int month)

Parameters

public void setSeconds (int second)

Parameters

public void setTime (long milliseconds)

Parameters

public void setYear (int year)

Parameters

public String toGMTString ()

Returns