构造方法详细信息

• SpinnerDateModel

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

  创建一个SpinnerDateModel ，表示start和end之间的日期序列。 nextValue和previousValue方法通过calendarField时间单位提前或反转当前日期value来计算序列的元素。 对于意味着什么递增或递减一个精确的描述Calendar 字段 ，请参阅add在方法java.util.Calendar 。

  start和end参数可以是null ，表示该范围没有上限或下限。 如果value或calendarField是null ，或者如果同时指定start和end并且minimum > maximum则抛出IllegalArgumentException 。 同样，如果(minimum <= value <= maximum)为false，则抛出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<java.util.Date>) ， setEnd(java.lang.Comparable<java.util.Date>) ， setCalendarField(int)

• SpinnerDateModel

  public SpinnerDateModel()

  构造一个 SpinnerDateModel ，其初始 value是当前日期， calendarField等于 Calendar.DAY_OF_MONTH ，以及用于其中有没有 start / end限制。

方法详细信息

• setStart

  public void setStart​(Comparable<Date> start)

  更改此序列中日期的下限。 如果start是null ，那么没有下限。 此处不进行边界检查：新的起始值可能使构造函数强制执行的(start <= value <= end)不变量无效。 这是为了简化模型的更新。 当然应该保证不变的是调用之前真正nextValue ， previousValue ，或setValue方法。

  通常，此属性为Date但是可以使用Comparable和compareTo方法进行日期。 例如， start可能是这样的类的实例：

    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);
       }
   } 

  需要注意的是上面的例子将抛出ClassCastException如果Object传递到compareTo(Object)不是Date 。

  如果start已更改，则此方法将触发ChangeEvent 。

  参数

  start - 定义序列中的第一个日期

  另请参见：

  getStart() ， setEnd(java.lang.Comparable<java.util.Date>) ， AbstractSpinnerModel.addChangeListener(javax.swing.event.ChangeListener)

• getStart

  public Comparable<Date> getStart()

  返回序列中的第一个 Date 。

  结果

  start属性的值

  另请参见：

  setStart(java.lang.Comparable<java.util.Date>)

• setEnd

  public void setEnd​(Comparable<Date> end)

  按此顺序更改Date的上限。 如果start是null ，那么没有上限。 此处不进行边界检查：新的起始值可能使构造函数强制执行的(start <= value <= end)不变量无效。 这是为了简化模型的更新。 当然，应该保证不变的是调用之前真正nextValue ， previousValue ，或setValue方法。

  通常，此属性是一个Date但是它可以使用Comparable与compareTo方法为Date秒。 有关setStart ，请参见setStart 。

  如果end已更改，则此方法将触发ChangeEvent 。

  参数

  end - 定义序列中的最后一个日期

  另请参见：

  getEnd() ， setStart(java.lang.Comparable<java.util.Date>) ， AbstractSpinnerModel.addChangeListener(javax.swing.event.ChangeListener)

• getEnd

  public Comparable<Date> getEnd()

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

  结果

  end属性的值

  另请参见：

  setEnd(java.lang.Comparable<java.util.Date>)

• 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

  如果calendarField已更改，则此方法将触发ChangeEvent 。

  另请参见：

  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()

  返回此序列中Date的当前元素。 此方法相当于(Date)getValue 。

  结果

  value属性

  另请参见：

  setValue(java.lang.Object)

• getValue

  public Object getValue()

  返回此序列中 Date的当前元素。

  Specified by:

  getValue在界面 SpinnerModel

  结果

  value属性

  另请参见：

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

• setValue

  public void setValue​(Object value)

  设置此序列的当前Date 。 如果value是null ，则抛出IllegalArgumentException 。 此处不进行边界检查：新值可能使构造函数强制执行的(start <= value < end)不变量无效。 当然，应该确保(start <= value <= maximum)不变的是调用之前真正nextValue ， previousValue ，或setValue方法。

  如果value已更改，则此方法将触发ChangeEvent 。

  Specified by:

  setValue接口 SpinnerModel

  参数

  value - 此序列的当前（非 null ） Date

  异常

  IllegalArgumentException - 如果值为 null或不是 Date

  另请参见：

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