J2ME in a Nutshell

Name

DateField

Synopsis

This class is an Item that displays and allows the user to edit the value of a date, a time or both date and time, held internally as a java.util.Date object. Like all Items, DateField can have a label that is displayed near to it to indicate its function.

The input mode, which can be one of DATE, TIME, or DATE_TIME, determines which parts of the Date object associated with the DateField are displayed for editing. It can be set at construction time or by calling the setInputMode() method.

By default, the DateField is initialized with a null date and time value. An explicit date and time can be set using the setDate() method, which requires a Date object containing the new value. If the DateField is in DATE, the time portion of the Date object is ignored. If it is in TIME mode, the date portion must be set to Jan 1st, 1970.

The date is displayed according to the default time zone for the device. A different time zone can be specified by passing a suitable TimeZone object to the constructor. However, the MIDP specification does not provide full support for time zones and therefore some restrictions on the available time zones might be encountered on some devices.

When the user interacts with the DateField and changes its value, the ItemStateListener for the Form on which the control appears is notified. The new date and time can be retrieved using the getDate() method.

                  
public class DateField extends Item {  
// Public Constructors
   public DateField( String ...