- All Implemented Interfaces:
Serializable
,SpinnerModel
SpinnerModel
for sequences of Date
s.
The upper and lower bounds of the sequence are defined by properties called
start
and end
and the size
of the increase or decrease computed by the nextValue
and previousValue
methods is defined by a property
called calendarField
. The start
and end
properties can be null
to
indicate that the sequence has no lower or upper limit.
The value of the calendarField
property must be one of the
java.util.Calendar
constants that specify a field
within a Calendar
. The getNextValue
and getPreviousValue
methods change the date forward or backwards by this amount.
For example, if calendarField
is Calendar.DAY_OF_WEEK
,
then nextValue
produces a Date
that's 24
hours after the current value
, and previousValue
produces a Date
that's 24 hours earlier.
The legal values for calendarField
are:
Calendar.ERA
Calendar.YEAR
Calendar.MONTH
Calendar.WEEK_OF_YEAR
Calendar.WEEK_OF_MONTH
Calendar.DAY_OF_MONTH
Calendar.DAY_OF_YEAR
Calendar.DAY_OF_WEEK
Calendar.DAY_OF_WEEK_IN_MONTH
Calendar.AM_PM
Calendar.HOUR
Calendar.HOUR_OF_DAY
Calendar.MINUTE
Calendar.SECOND
Calendar.MILLISECOND
This model inherits a ChangeListener
. The
ChangeListeners
are notified whenever the models
value
, calendarField
,
start
, or end
properties changes.
- Since:
- 1.4
- See Also:
-
Field Summary
Fields declared in class javax.swing.AbstractSpinnerModel
listenerList
-
Constructor Summary
ConstructorDescriptionConstructs aSpinnerDateModel
whose initialvalue
is the current date,calendarField
is equal toCalendar.DAY_OF_MONTH
, and for which there are nostart
/end
limits.SpinnerDateModel
(Date value, Comparable<Date> start, Comparable<Date> end, int calendarField) Creates aSpinnerDateModel
that represents a sequence of dates betweenstart
andend
. -
Method Summary
Modifier and TypeMethodDescriptionint
Returns theCalendar
field that is added to or subtracted from by thenextValue
andpreviousValue
methods.getDate()
Returns the current element in this sequence ofDate
s.getEnd()
Returns the lastDate
in the sequence.Returns the nextDate
in the sequence, ornull
if the next date is afterend
.Returns the previousDate
in the sequence, ornull
if the previous date is beforestart
.getStart()
Returns the firstDate
in the sequence.getValue()
Returns the current element in this sequence ofDate
s.void
setCalendarField
(int calendarField) Changes the size of the date value change computed by thenextValue
andpreviousValue
methods.void
setEnd
(Comparable<Date> end) Changes the upper limit forDate
s in this sequence.void
setStart
(Comparable<Date> start) Changes the lower limit for Dates in this sequence.void
Sets the currentDate
for this sequence.Methods declared in class javax.swing.AbstractSpinnerModel
addChangeListener, fireStateChanged, getChangeListeners, getListeners, removeChangeListener
-
Constructor Details
-
SpinnerDateModel
public SpinnerDateModel(Date value, Comparable<Date> start, Comparable<Date> end, int calendarField) Creates aSpinnerDateModel
that represents a sequence of dates betweenstart
andend
. ThenextValue
andpreviousValue
methods compute elements of the sequence by advancing or reversing the current datevalue
by thecalendarField
time unit. For a precise description of what it means to increment or decrement aCalendar
field
, see theadd
method injava.util.Calendar
.The
start
andend
parameters can benull
to indicate that the range doesn't have an upper or lower bound. Ifvalue
orcalendarField
isnull
, or if bothstart
andend
are specified andminimum > maximum
then anIllegalArgumentException
is thrown. Similarly if(minimum <= value <= maximum)
is false, an IllegalArgumentException is thrown.- Parameters:
value
- the current (nonnull
) value of the modelstart
- the first date in the sequence ornull
end
- the last date in the sequence ornull
calendarField
- one ofCalendar.ERA
Calendar.YEAR
Calendar.MONTH
Calendar.WEEK_OF_YEAR
Calendar.WEEK_OF_MONTH
Calendar.DAY_OF_MONTH
Calendar.DAY_OF_YEAR
Calendar.DAY_OF_WEEK
Calendar.DAY_OF_WEEK_IN_MONTH
Calendar.AM_PM
Calendar.HOUR
Calendar.HOUR_OF_DAY
Calendar.MINUTE
Calendar.SECOND
Calendar.MILLISECOND
- Throws:
IllegalArgumentException
- ifvalue
orcalendarField
arenull
, ifcalendarField
isn't valid, or if the following expression is false:(start <= value <= end)
.- See Also:
-
SpinnerDateModel
public SpinnerDateModel()Constructs aSpinnerDateModel
whose initialvalue
is the current date,calendarField
is equal toCalendar.DAY_OF_MONTH
, and for which there are nostart
/end
limits.
-
-
Method Details
-
setStart
Changes the lower limit for Dates in this sequence. Ifstart
isnull
, then there is no lower limit. No bounds checking is done here: the new start value may invalidate the(start <= value <= end)
invariant enforced by the constructors. This is to simplify updating the model. Naturally one should ensure that the invariant is true before calling thenextValue
,previousValue
, orsetValue
methods.Typically this property is a
Date
however it's possible to use aComparable
with acompareTo
method for Dates. For examplestart
might be an instance of a class like this:MyStartDate implements Comparable { long t = 12345; public int compareTo(Date d) { return (t < d.getTime() ? -1 : (t == d.getTime() ? 0 : 1)); } public int compareTo(Object o) { return compareTo((Date)o); } }
Note that the above example will throw aClassCastException
if theObject
passed tocompareTo(Object)
is not aDate
.This method fires a
ChangeEvent
if thestart
has changed.- Parameters:
start
- defines the first date in the sequence- See Also:
-
getStart
Returns the firstDate
in the sequence.- Returns:
- the value of the
start
property - See Also:
-
setEnd
Changes the upper limit forDate
s in this sequence. Ifstart
isnull
, then there is no upper limit. No bounds checking is done here: the new start value may invalidate the(start <= value <= end)
invariant enforced by the constructors. This is to simplify updating the model. Naturally, one should ensure that the invariant is true before calling thenextValue
,previousValue
, orsetValue
methods.Typically this property is a
Date
however it's possible to useComparable
with acompareTo
method forDate
s. SeesetStart
for an example.This method fires a
ChangeEvent
if theend
has changed.- Parameters:
end
- defines the last date in the sequence- See Also:
-
getEnd
Returns the lastDate
in the sequence.- Returns:
- the value of the
end
property - See Also:
-
setCalendarField
public void setCalendarField(int calendarField) Changes the size of the date value change computed by thenextValue
andpreviousValue
methods. ThecalendarField
parameter must be one of theCalendar
field constants likeCalendar.MONTH
orCalendar.MINUTE
. ThenextValue
andpreviousValue
methods simply move the specifiedCalendar
field forward or backward by one unit with theCalendar.add
method. You should use this method with care as some UIs may set the calendarField before committing the edit to spin the field under the cursor. If you only want one field to spin you can subclass and ignore the setCalendarField calls.- Parameters:
calendarField
- one ofCalendar.ERA
Calendar.YEAR
Calendar.MONTH
Calendar.WEEK_OF_YEAR
Calendar.WEEK_OF_MONTH
Calendar.DAY_OF_MONTH
Calendar.DAY_OF_YEAR
Calendar.DAY_OF_WEEK
Calendar.DAY_OF_WEEK_IN_MONTH
Calendar.AM_PM
Calendar.HOUR
Calendar.HOUR_OF_DAY
Calendar.MINUTE
Calendar.SECOND
Calendar.MILLISECOND
This method fires a
ChangeEvent
if thecalendarField
has changed.- See Also:
-
getCalendarField
public int getCalendarField()Returns theCalendar
field that is added to or subtracted from by thenextValue
andpreviousValue
methods.- Returns:
- the value of the
calendarField
property - See Also:
-
getNextValue
Returns the nextDate
in the sequence, ornull
if the next date is afterend
.- Specified by:
getNextValue
in interfaceSpinnerModel
- Returns:
- the next
Date
in the sequence, ornull
if the next date is afterend
. - See Also:
-
getPreviousValue
Returns the previousDate
in the sequence, ornull
if the previous date is beforestart
.- Specified by:
getPreviousValue
in interfaceSpinnerModel
- Returns:
- the previous
Date
in the sequence, ornull
if the previous date is beforestart
- See Also:
-
getDate
Returns the current element in this sequence ofDate
s. This method is equivalent to(Date)getValue
.- Returns:
- the
value
property - See Also:
-
getValue
Returns the current element in this sequence ofDate
s.- Specified by:
getValue
in interfaceSpinnerModel
- Returns:
- the
value
property - See Also:
-
setValue
Sets the currentDate
for this sequence. Ifvalue
isnull
, anIllegalArgumentException
is thrown. No bounds checking is done here: the new value may invalidate the(start <= value < end)
invariant enforced by the constructors. Naturally, one should ensure that the(start <= value <= maximum)
invariant is true before calling thenextValue
,previousValue
, orsetValue
methods.This method fires a
ChangeEvent
if thevalue
has changed.- Specified by:
setValue
in interfaceSpinnerModel
- Parameters:
value
- the current (nonnull
)Date
for this sequence- Throws:
IllegalArgumentException
- if value isnull
or not aDate
- See Also:
-