javax.swing

Class SpinnerDateModel

java.lang.Object

javax.swing.AbstractSpinnerModel

javax.swing.SpinnerDateModel

All Implemented Interfaces:

Serializable， SpinnerModel

public class SpinnerDateModel
extends AbstractSpinnerModel
implements Serializable

一个序列的 Dates SpinnerModel。序列的上限和下限定义的性质称为 start和 end和大小的增加或减少的 nextValue和 previousValue方法计算的特性称为 calendarField定义， start和 end属性可以 null表明序列无下限或上限极限。

该calendarField属性的值必须是一个指定的领域内的一个Calendar java.util.Calendar常数。的getNextValue和getPreviousValue方法更改日期向前或向后的量。例如，如果calendarField是Calendar.DAY_OF_WEEK，然后nextValue产生Date是当前value 24小时后，和previousValue产生Date那24小时前。

对于calendarField法律价值：

• 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

然而一些UI可以设定calendarfield之前编辑旋转磁场下光标。如果你只想要一场旋转，你可以子类化而忽视setcalendarfield电话。

该模型继承了ChangeListener，ChangeListeners通知每当模型value，calendarField，start，或end性质的变化。

从以下版本开始：

一点四

另请参见：

JSpinner， SpinnerModel， AbstractSpinnerModel， SpinnerListModel， SpinnerNumberModel， Calendar.add(int, int)

Field Summary

Fields inherited from class javax.swing.AbstractSpinnerModel

listenerList

构造方法摘要

构造方法

Constructor and Description
SpinnerDateModel() 构建了一个 SpinnerDateModel的初始 value是当前日期， calendarField等于 Calendar.DAY_OF_MONTH，并没有 start / end限制。
SpinnerDateModel(Date value, Comparable start, Comparable end, int calendarField) 创建一个 SpinnerDateModel表示序列的 start和 end之间的日期。

方法摘要

Modifier and Type	Method and Description
int	getCalendarField() 返回 Calendar场，增加或减少的 nextValue和 previousValue方法。
Date	getDate() 在这一系列 Dates返回当前元素。
Comparable	getEnd() 返回序列中的最后一个 Date。
Object	getNextValue() 返回序列中的下一个 Date，或 null如果下一个日期是在 end。
Object	getPreviousValue() 返回序列中的前 Date，或 null如果以前的日期是在 start。
Comparable	getStart() 返回序列中的第一个 Date。
Object	getValue() 在这一系列 Dates返回当前元素。
void	setCalendarField(int calendarField) 变化的日期值变化的 nextValue和 previousValue方法计算尺寸。
void	setEnd(Comparable end) 在这个序列的变化 Dates上限。
void	setStart(Comparable start) 更改此序列中日期的下限。
void	setValue(Object value) 设置当前的这个序列 Date。

Methods inherited from class javax.swing.AbstractSpinnerModel

addChangeListener, fireStateChanged, getChangeListeners, getListeners, removeChangeListener

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SpinnerDateModel

public SpinnerDateModel(Date value,
                        Comparable start,
                        Comparable end,
                        int calendarField)

创建一个 SpinnerDateModel表示序列的 start和 end之间的日期。的 nextValue和 previousValue方法计算元素的序列，通过推进或由 calendarField时间单位扭转当前日期 value。一个精确的描述什么是递增或递减 Calendar field，看到 java.util.Calendar add

的start和end参数可以null表明范围没有上限或下限。如果value或calendarField是null，或如果start和end指定并minimum > maximum然后IllegalArgumentException抛出。同样，如果(minimum <= value <= maximum)是假的，IllegalArgumentException是抛出。

的方法。

参数

value -电流（非 null）模型的价值

start在序列或 null第一次约会

end -序列中的最后一个日期或 null

calendarField -一个

• 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 -如果 value或 calendarField是 null，如果 calendarField不是有效的，如果下面的表达式是错误的： (start <= value <= end)。

另请参见：

Calendar.add(int, int)， setValue(java.lang.Object)， setStart(java.lang.Comparable)， setEnd(java.lang.Comparable)， setCalendarField(int)

SpinnerDateModel

public SpinnerDateModel()

构建了一个 SpinnerDateModel的初始 value是当前日期， calendarField等于 Calendar.DAY_OF_MONTH，并没有 start / end限制。

方法详细信息

setStart

public void setStart(Comparable start)

更改此序列中日期的下限。如果 start是 null，那么没有下限。没有边界检查是在这里完成的：新的开始值可能会使 (start <= value <= end)不变的构造函数执行。这是简化模型的更新。自然人应确保在调用 nextValue， previousValue不变是真的，或 setValue方法。

通常，此属性是一个Date然而使用Comparable与compareTo方法日期是可能的。例如start可能是一类这样的实例：

mystartdate实现类似{长T = 12345；public int compareTo（日期D）{返回（t＜D. gettime()？1：（T = = D gettime()？0：1）；}public int compareTo（Object o）{返回compareTo（（日期）O）；}}

注意上面的例子如果 Object通过 compareTo(Object)不是 Date扔 ClassCastException。

这种方法火灾ChangeEvent如果start已经改变。

参数

start -定义的第一次约会在序列

另请参见：

getStart()， setEnd(java.lang.Comparable)， AbstractSpinnerModel.addChangeListener(javax.swing.event.ChangeListener)

getStart

public Comparable getStart()

返回序列中的第一个 Date。

结果

该 start属性的值

另请参见：

setStart(java.lang.Comparable)

setEnd

public void setEnd(Comparable end)

在这个序列的变化 Dates上限。如果 start是 null，然后没有上限。没有边界检查是在这里完成的：新的开始值可能会使 (start <= value <= end)不变的构造函数执行。这是简化模型的更新。当然，要确保调用之前 nextValue，不变的是真实的 previousValue，或 setValue方法。

通常，此属性是一个Date然而使用Comparable有Dates compareTo方法是可能的。看到一个例子setStart。

这种方法火灾ChangeEvent如果end已经改变。

参数

end在序列定义的最后日期

另请参见：

getEnd()， setStart(java.lang.Comparable)， AbstractSpinnerModel.addChangeListener(javax.swing.event.ChangeListener)

getEnd

public Comparable getEnd()

返回序列中的最后一个 Date。

结果

该 end属性的值

另请参见：

setEnd(java.lang.Comparable)

setCalendarField

public void setCalendarField(int calendarField)

变化的日期值变化的 nextValue和 previousValue方法计算尺寸。该参数必须是一个 calendarField的 Calendar场常数如 Calendar.MONTH或 Calendar.MINUTE， nextValue和 previousValue方法只需将指定的 Calendar领域前进或后退一个单位的 Calendar.add方法。你应该使用这个方法，小心一些UI可以设定calendarfield之前编辑旋转磁场下光标。如果你只想要一场旋转，你可以子类化而忽视setcalendarfield电话。

参数

calendarField -一个

• 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

这种方法火灾ChangeEvent如果calendarField已经改变。

另请参见：

getCalendarField()， getNextValue()， getPreviousValue()， Calendar.add(int, int)， AbstractSpinnerModel.addChangeListener(javax.swing.event.ChangeListener)

getCalendarField

public int getCalendarField()

返回的是增加或减少的 nextValue和 previousValue方法 Calendar场。

结果

该 calendarField属性的值

另请参见：

setCalendarField(int)

getNextValue

public Object getNextValue()

返回序列中的下一个 Date，或 null如果下一个日期是在 end。

Specified by:

getNextValue 接口 SpinnerModel

结果

序列中的下一个 Date，或 null如果下一个日期是在 end。

另请参见：

SpinnerModel.getNextValue()， getPreviousValue()， setCalendarField(int)

getPreviousValue

public Object getPreviousValue()

返回序列中的前 Date，或 null如果以前的日期是在 start。

Specified by:

getPreviousValue 接口 SpinnerModel

结果

在序列上 Date，或 null如果以前的日期是在 start

另请参见：

SpinnerModel.getPreviousValue()， getNextValue()， setCalendarField(int)

getDate

public Date getDate()

在这一系列 Dates返回当前元素。这种方法相当于 (Date)getValue。

结果

的 value财产

另请参见：

setValue(java.lang.Object)

getValue

public Object getValue()

在这一系列 Dates返回当前元素。

Specified by:

getValue 接口 SpinnerModel

结果

的 value财产

另请参见：

setValue(java.lang.Object)， getDate()

setValue

public void setValue(Object value)

设置当前的这个序列 Date。如果 value是 null，一 IllegalArgumentException抛出。没有边界检查是在这里完成的：新的价值可能会使 (start <= value < end)不变的构造函数执行。当然，要确保在调用 nextValue， previousValue的 (start <= value <= maximum)不变是真的，或 setValue方法。

这种方法火灾ChangeEvent如果value已经改变。

Specified by:

setValue 接口 SpinnerModel

参数

value -电流（非 null） Date这个序列

异常

IllegalArgumentException如果值是 null或不 Date

另请参见：

getDate()， getValue()， AbstractSpinnerModel.addChangeListener(javax.swing.event.ChangeListener)