AS/400 Toolbox for Java \ Graphical Toolbox \ Spinner \ DateSpinner

Date spinner

Start changeThe date spinner displays and spins the date. You can change the date value by clicking on different sub fields and spinning on them. You can also type in a date string to set the current value.

Properties

Property Description Data Type Flags* Default Value Valid Value
wrapAssociated Marks whether the changes of different field values are associated. For example if wrapAssociated is true and the current value is "1998,12", the year will change from 1998 to 1999 when the value of the month is incremented. boolean R, W, B True True - field values are associated
False - field values are not associated
year The year. int R, W, B, E The current system year. valid year
month The month.
Note: the property value of month is from 0 to 11, but it displays 1 to 12 as its value in the UI. This is to keep it consistent with WebRunner and JDK
int R, W, B, E The current system month. integer from 1 to 12
day The day int R, W, B, E The current system day. valid days
formatString The user-defined pattern string for formatting and parsing the date. String R, W, B "dd - MMM - yy" FULL - "EEEE,MMMM d,yyyy"
LONG - "MMMM d,yyyy"
MEDIUM - "dd-MMM-yy"
SHORT - "M/d/yy"
formattingStyle The ID of format string.
Note:This property is the same as the formatString property. However, to keep compatible with Webrunner API, it cannot be eliminated. Therefore, it is a hidden property and can only be manipulated by the set/get methods.
int R, W, B, H 2 0 - FULL
1 - LONG
2 - MEDIUM
3 - SHORT
caretPos The caret position which represents the current field to be changed. It can be one of YEAR, MONTH, or DATE.
Note:The "caretPos" property of DateSpinner not similar to the caret position defined in the TextField. Therefore, when you manipulate DateSpinner, the caret position displayed in the input field may not be consistent with the value of the caret position displayed in the property sheet.
int R, W, B 0 0 - YEAR
1 - MONTH
2 - DATE
value The calendar value in long. long R, W, B, E The current system calendar in long. minimum<value <maximum
calendar
(display name:Date)
The calendar value in calendar. java.util.Calendar R, W, B The current system calendar. any instance of Calendar
maximum The maximum value. java.util.Calendar R, W, B 12/31/2050 maximum>minimum
minimum The minimum value. java.util.Calendar R, W, B 01/01/1950 any instance of Calendar
dateString The date shown in the entry field. String R, W, B, E The current system date. any instance of valid date string

* R = read, W = write, B=bound, E =expert, H = hidden

Events

The date spinner fires the DateChangedEvent. The listener method for this event is dateChanged(com.ibm.spinner.DateChangedEvent)

User interface

The currently selected value is displayed in an input field. The following picture shows what this may look like:
You can change the date value by clicking on different sub fields within the input field and using the arrow buttons to spin them. You can also set the values by typing a date string into the input field. If the input is invalid, the DateSpinner restores the previous value after you press the "Enter" or "Tab" key or when you change the focus to another component.End change
[ Information Center Home Page ] [ Legal | AS/400 Glossary ]