Класс SpinnerDateModel

public class SpinnerDateModel
extends AbstractSpinnerModel
implements Serializable

Модель для последовательностей Date. Верхняя и нижняя границы последовательности определяются свойствами, называемыми start и end, а размер приращения или уменьшения, вычисляемый методами nextValue и previousValue, определяется свойством calendarField. Свойства start и end могут быть null для указания отсутствия нижней или верхней границы последовательности.

Значение свойства calendarField должно быть одним из констант java.util.Calendar, определяющих поле в Calendar. Методы getNextValue и getPreviousValue изменяют дату вперёд или назад на это количество. Например, если calendarField равно Calendar.DAY_OF_WEEK, то nextValue возвращает Date, которая на 24 часа позже текущей value, а 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

Однако некоторые пользовательские интерфейсы могут установить calendarField перед подтверждением редактирования, чтобы изменить поле под курсором. Если вы хотите изменить только одно поле, вы можете создать подкласс и проигнорировать вызовы setCalendarField.

Эта модель наследует ChangeListener. ChangeListeners уведомляются всякий раз, когда изменяются свойства модели value, calendarField, start или end.

Подробное описание конструкторов

SpinnerDateModel

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

Создаёт SpinnerDateModel, представляющую последовательность дат между start и end. Методы nextValue и previousValue вычисляют элементы последовательности, перемещая текущую дату value вперёд или назад на calendarField единицу времени. Подробное описание того, что означает приращение или уменьшение Calendar field, см. в методе add в java.util.Calendar.

Параметры 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<java.util.Date>), setEnd(java.lang.Comparable<java.util.Date>), setCalendarField(int)

SpinnerDateModel

public SpinnerDateModel()

Создаёт SpinnerDateModel, у которого начальное значение value — текущая дата, calendarField равно Calendar.DAY_OF_MONTH, и нет ограничений start/end.