J2ME in a Nutshell

Name

Date

Synopsis

The Date class represents a date and time held internally as a millisecond offset from 0:00 UTC on January 1st, 1970. The default constructor creates a Date that represents the date and time at the time of its creation. A Date object for an arbitrary time can be created by passing the appropriate offset to the Date(long offset) constructor. Negative offsets can be used to represent dates in 1969 and earlier years. The time associated with a Date can be changed using the setTime() method and the time offset for a Date can be obtained using getTime().

The CLDC version of Date is much simpler than the J2SE implementation. Deprecated APIs and constructors have been removed, as have methods that allow two Date objects to be compared. A consequence of this is that it is no longer possible to convert between a Date object and the corresponding parts of a date, such as year, month, day, etc. The Calendar class must be used to perform these conversions instead.

Note that a Date object always contains a time offset measured relative to UTC. To work in other time zones, an appropriate TimeZone object must be obtained and used together with an instance of the Calendar class.

public class Date {  
// Public Constructors
   public Date();  
   public Date( long date);    
// Public Instance Methods
   public long getTime();                                        // default:1010205995686
   public void setTime( long time);    
// Public Methods Overriding Object
   public boolean equals( Object obj);  
   public int hashCode();  
}

Passed To