Android
java.util
public class

java.util.Date

java.lang.Object
java.util.Date Serializable Cloneable Comparable<T>

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

Known Direct Subclasses

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
Methods inherited from class java.lang.Object
Methods inherited from interface java.lang.Comparable

Details

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

See Also

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

See Also

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

See Also

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
Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:56