Serializable
, SpinnerModel
public class SpinnerDateModel extends AbstractSpinnerModel implements Serializable
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.
listenerList
Constructor | Description |
---|---|
SpinnerDateModel() |
Constructs a SpinnerDateModel whose initial value is the current date, calendarField is equal to Calendar.DAY_OF_MONTH , and for which there are no start /end limits. |
SpinnerDateModel |
Creates a SpinnerDateModel that represents a sequence of dates between start and end . |
Modifier and Type | Method | Description |
---|---|---|
int |
getCalendarField() |
Returns the Calendar field that is added to or subtracted from by the nextValue and previousValue methods. |
Date |
getDate() |
Returns the current element in this sequence of Date s. |
Comparable |
getEnd() |
Returns the last Date in the sequence. |
Object |
getNextValue() |
Returns the next Date in the sequence, or null if the next date is after end . |
Object |
getPreviousValue() |
Returns the previous Date in the sequence, or null if the previous date is before start . |
Comparable |
getStart() |
Returns the first Date in the sequence. |
Object |
getValue() |
Returns the current element in this sequence of Date s. |
void |
setCalendarField |
Changes the size of the date value change computed by the nextValue and previousValue methods. |
void |
setEnd |
Changes the upper limit for Date s in this sequence. |
void |
setStart |
Changes the lower limit for Dates in this sequence. |
void |
setValue |
Sets the current Date for this sequence. |
addChangeListener, fireStateChanged, getChangeListeners, getListeners, removeChangeListener
public SpinnerDateModel(Date value, Comparable<Date> start, Comparable<Date> end, int calendarField)
SpinnerDateModel
that represents a sequence of dates between start
and end
. The nextValue
and previousValue
methods compute elements of the sequence by advancing or reversing the current date value
by the calendarField
time unit. For a precise description of what it means to increment or decrement a Calendar
field
, see the add
method in java.util.Calendar
. The start
and end
parameters can be null
to indicate that the range doesn't have an upper or lower bound. If value
or calendarField
is null
, or if both start
and end
are specified and minimum > maximum
then an IllegalArgumentException
is thrown. Similarly if (minimum <= value <= maximum)
is false, an IllegalArgumentException is thrown.
value
- the current (non null
) value of the modelstart
- the first date in the sequence or null
end
- the last date in the sequence or null
calendarField
- one of 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
IllegalArgumentException
- if value
or calendarField
are null
, if calendarField
isn't valid, or if the following expression is false: (start <= value <= end)
.public SpinnerDateModel()
SpinnerDateModel
whose initial value
is the current date, calendarField
is equal to Calendar.DAY_OF_MONTH
, and for which there are no start
/end
limits.public void setStart(Comparable<Date> start)
start
is null
, 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 the nextValue
, previousValue
, or setValue
methods. Typically this property is a Date
however it's possible to use a Comparable
with a compareTo
method for Dates. For example start
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 a
ClassCastException
if the Object
passed to compareTo(Object)
is not a Date
. This method fires a ChangeEvent
if the start
has changed.
start
- defines the first date in the sequencepublic Comparable<Date> getStart()
Date
in the sequence.start
propertypublic void setEnd(Comparable<Date> end)
Date
s in this sequence. If start
is null
, 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 the nextValue
, previousValue
, or setValue
methods. Typically this property is a Date
however it's possible to use Comparable
with a compareTo
method for Date
s. See setStart
for an example.
This method fires a ChangeEvent
if the end
has changed.
end
- defines the last date in the sequencepublic Comparable<Date> getEnd()
Date
in the sequence.end
propertypublic void setCalendarField(int calendarField)
nextValue
and previousValue
methods. The calendarField
parameter must be one of the Calendar
field constants like Calendar.MONTH
or Calendar.MINUTE
. The nextValue
and previousValue
methods simply move the specified Calendar
field forward or backward by one unit with the Calendar.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.calendarField
- one of 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 method fires a ChangeEvent
if the calendarField
has changed.
public int getCalendarField()
Calendar
field that is added to or subtracted from by the nextValue
and previousValue
methods.calendarField
propertypublic Object getNextValue()
Date
in the sequence, or null
if the next date is after end
.getNextValue
in interface SpinnerModel
Date
in the sequence, or null
if the next date is after end
.public Object getPreviousValue()
Date
in the sequence, or null
if the previous date is before start
.getPreviousValue
in interface SpinnerModel
Date
in the sequence, or null
if the previous date is before start
public Date getDate()
Date
s. This method is equivalent to (Date)getValue
.value
propertypublic Object getValue()
Date
s.getValue
in interface SpinnerModel
value
propertypublic void setValue(Object value)
Date
for this sequence. If value
is null
, an IllegalArgumentException
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 the nextValue
, previousValue
, or setValue
methods. This method fires a ChangeEvent
if the value
has changed.
setValue
in interface SpinnerModel
value
- the current (non null
) Date
for this sequenceIllegalArgumentException
- if value is null
or not a Date
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/SpinnerDateModel.html