| java.lang.Object
 javax.microedition.lcdui.Item
javax.microedition.lcdui.DateField
| DateField | | public class DateField extends Item (Code) | | A DateField is an editable component for presenting
date and time (calendar)
information that may be placed into a Form. Value for
this field can be
initially set or left unset. If value is not set then the UI for the field
shows this clearly. The field value for "not initialized
state" is not valid
value and getDate() for this state returns null.
Instance of a DateField can be configured to accept
date or time information
or both of them. This input mode configuration is done by
DATE, TIME or
DATE_TIME static fields of this
class. DATE input mode allows to set only
date information and TIME only time information
(hours, minutes). DATE_TIME
allows to set both clock time and date values.
In TIME input mode the date components of
Date object
must be set to the "zero epoch" value of January 1, 1970.
Calendar calculations in this field are based on default locale and defined
time zone. Because of the calculations and different input modes date object
may not contain same millisecond value when set to this field and get back
from this field.
since:
MIDP 1.0 |
| Field Summary | |
| final public static int | DATE
Input mode for date information (day, month, year). | | final public static int | DATE_TIME
Input mode for date (day, month, year) and time (minutes, hours)
information. | | final public static int | TIME
Input mode for time information (hours and minutes). | | Calendar | currentDate
The last saved date. | | DateFieldLF | dateFieldLF
The look&feel associated with this DateField. | | boolean | initialized
| | int | mode
|
| Constructor Summary | |
| public | DateField(String label, int mode)
Creates a DateField object with the specified
label and mode. | | public | DateField(String label, int mode, java.util.TimeZone timeZone)
Creates a date field in which calendar calculations are based
on specific
TimeZone object and the default calendaring system for the
current locale. |
| DATE | | final public static int DATE(Code) | | Input mode for date information (day, month, year). With this mode this
DateField presents and allows only to modify date
value. The time
information of date object is ignored.
Value 1 is assigned to DATE.
|
| DATE_TIME | | final public static int DATE_TIME(Code) | | Input mode for date (day, month, year) and time (minutes, hours)
information. With this mode this DateField
presents and allows to modify
both time and date information.
Value 3 is assigned to DATE_TIME.
|
| TIME | | final public static int TIME(Code) | | Input mode for time information (hours and minutes). With this mode this
DateField presents and allows only to modify
time. The date components
should be set to the "zero epoch" value of January 1, 1970 and
should not be accessed.
Value 2 is assigned to TIME.
|
| currentDate | | Calendar currentDate(Code) | | The last saved date.
This is used for making the last saved date bold.
|
| dateFieldLF | | DateFieldLF dateFieldLF(Code) | | The look&feel associated with this DateField.
Set in the constructor.
|
| initialized | | boolean initialized(Code) | | A flag indicating the initialization state of this DateField
|
| mode | | int mode(Code) | | The mode of this DateField
|
| DateField | | public DateField(String label, int mode)(Code) | | Creates a DateField object with the specified
label and mode. This call
is identical to DateField(label, mode, null).
Parameters:
label - item label
Parameters:
mode - the input mode, one of DATE, TIMEor DATE_TIME
throws:
IllegalArgumentException - if the input mode'svalue is invalid |
| DateField | | public DateField(String label, int mode, java.util.TimeZone timeZone)(Code) | | Creates a date field in which calendar calculations are based
on specific
TimeZone object and the default calendaring system for the
current locale.
The value of the DateField is initially in the
"uninitialized" state.
If timeZone is null, the system's
default time zone is used.
Parameters:
label - item label
Parameters:
mode - the input mode, one of DATE, TIMEor DATE_TIME
Parameters:
timeZone - a specific time zone, or null for thedefault time zone
throws:
IllegalArgumentException - if the input mode's valueis invalid |
| acceptFocus | | boolean acceptFocus()(Code) | | Return whether the Item takes user input focus.
Always return true |
| getDate | | public java.util.Date getDate()(Code) | | Returns date value of this field. Returned value is
null if field
value is
not initialized. The date object is constructed according the rules of
locale specific calendaring system and defined time zone.
In TIME mode field the date components are set to
the "zero
epoch" value of January 1, 1970. If a date object that presents
time beyond one day from this "zero epoch" then this field
is in "not
initialized" state and this method returns null.
In DATE mode field the time component of the calendar is
set to zero when constructing the date object.
date object representing time or date depending on input mode
See Also: DateField.setDate |
| getInputMode | | public int getInputMode()(Code) | | Gets input mode for this date field. Valid input modes are
DATE, TIME and DATE_TIME.
input mode of this field
See Also: DateField.setInputMode |
| setDate | | public void setDate(java.util.Date date)(Code) | | Sets a new value for this field. null can be
passed to set the field
state to "not initialized" state. The input mode of
this field defines
what components of passed Date object is used.
In TIME input mode the date components must be set
to the "zero
epoch" value of January 1, 1970. If a date object that presents
time
beyond one day then this field is in "not initialized" state.
In TIME input mode the date component of
Date object is ignored and time
component is used to precision of minutes.
In DATE input mode the time component of
Date object is ignored.
In DATE_TIME input mode the date and time
component of Date are used but
only to precision of minutes.
Parameters:
date - new value for this field
See Also: DateField.getDate |
| setDateImpl | | void setDateImpl(java.util.Date date)(Code) | | Sets the date.
Parameters:
date - the date value to set to. |
| setInputMode | | public void setInputMode(int mode)(Code) | | Set input mode for this date field. Valid input modes are
DATE, TIME and DATE_TIME.
Parameters:
mode - the input mode, must be one of DATE,TIME or DATE_TIME
throws:
IllegalArgumentException - if an invalid value is specified
See Also: DateField.getInputMode |
|
|