public class

Date

extends Object
implements Serializable Cloneable Comparable<T>
java.lang.Object
   ↳ java.util.Date
Known Direct Subclasses

Class Overview

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

Summary

Public Constructors
Date()
Initializes this Date instance to the current 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)
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 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 a string representation of this Date.
[Expand]
Inherited Methods
From class java.lang.Object
From interface java.lang.Comparable

Public Constructors

public Date ()

Since: API Level 1

Initializes this Date instance to the current time.

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

Since: API Level 1

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)

Since: API Level 1

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)

Since: API Level 1

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)

Since: API Level 1

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)

Since: API Level 1

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)

Since: API Level 1

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
  • the date and time in GMT in milliseconds.

public boolean after (Date date)

Since: API Level 1

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)

Since: API Level 1

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

public Object clone ()

Since: API Level 1

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

Returns
  • a shallow copy of this Date.
See Also

public int compareTo (Date date)

Since: API Level 1

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

Parameters
date a Date to compare against.
Returns
  • an int < 0 if this Date is less than the specified Date, 0 if they are equal, and an int > 0 if this Date is greater.

public boolean equals (Object object)

Since: API Level 1

Compares the specified object to this Date and returns if they are equal. To be 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.
See Also

public int getDate ()

Since: API Level 1

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

Since: API Level 1

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

Since: API Level 1

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

Since: API Level 1

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

Since: API Level 1

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

Returns the gregorian calendar month for this Date object.

Returns
  • the month.

public int getSeconds ()

Since: API Level 1

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

Since: API Level 1

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

Returns
  • the number of milliseconds since Jan. 1, 1970, midnight GMT.

public int getTimezoneOffset ()

Since: API Level 1

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

Since: API Level 1

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

Since: API Level 1

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

Returns
  • this Date's hash.
See Also

public static long parse (String string)

Since: API Level 1

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)

Since: API Level 1

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)

Since: API Level 1

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)

Since: API Level 1

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)

Since: API Level 1

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)

Since: API Level 1

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)

Since: API Level 1

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)

Since: API Level 1

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

Since: API Level 1

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

public String toLocaleString ()

Since: API Level 1

This method is deprecated.
use DateFormat

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

public String toString ()

Since: API Level 1

Returns a string representation of this Date. The formatting is equivalent to using a SimpleDateFormat with the format string "EEE MMM dd HH:mm:ss zzz yyyy", which looks something like "Tue Jun 22 13:07:00 PDT 1999". The current default time zone and locale are used. If you need control over the time zone or locale, use SimpleDateFormat instead.

Returns
  • a printable representation of this object.