javax.swing
클래스 SpinnerDateModel

java.lang.Object 
  javax.swing.AbstractSpinnerModel 
      javax.swing.SpinnerDateModel

모든 구현된 인터페이스:

Serializable, SpinnerModel

public class SpinnerDateModel
extends AbstractSpinnerModel 
implements Serializable 

Date 순서의 SpinnerModel 입니다. 순서의 상한과 하한은, start 및 end 라고 하는 프로퍼티에 의해 정의합니다. nextValue 메서드와 previousValue 메서드에 의해 계산되는 증가분 또는 감소분은, calendarField 라고 하는 프로퍼티에 의해 정의합니다. 순서에 상한 또는 하한이 없는 것을 나타내기 위해서 start 프로퍼티 또는 end 프로퍼티를 null로 할 수 있습니다.

calendarField 프로퍼티의 값은, Calendar 필드를 나타내는 java.util.Calendar 정수의 어떤 것인가일 필요가 있습니다. getNextValue 메서드와 getPreviousValue 메서드는 이 정수에 근거해 날짜와 시간를 전후로 변경합니다. 예를 들어, calendarField가 Calendar.DAY_OF_WEEK인 경우, nextValue는 현재의 value 24 시간 후의 Date를 생성해, previousValue는 24 시간전의 Date를 생성합니다.

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를 설정하고 나서, 편집을 확정해 커서아래에 있는 필드를 스핀 할 수 있습니다. 1 필드만을 스핀 하는 경우는 setCalendarField 호출을 상속해 무시할 수 있습니다.

이 모델은 ChangeListener를 상속합니다. 모델의 value, calendarField, start, end 각 프로퍼티가 변경되었을 때에는 ChangeListeners 으로 변경이 통지됩니다.

도입된 버전 :

1.4

관련 항목:

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

필드 개요

클래스 javax.swing. AbstractSpinnerModel 로부터 상속된 필드

listenerList

생성자 개요

SpinnerDateModel ()
초기의 value가 현재의 값으로calendarField가 Calendar.DAY_OF_MONTH에 동일하고, start와 end에 한도가 없는 SpinnerDateModel을 구축합니다.

SpinnerDateModel (Date value, Comparable start, Comparable end, int calendarField)
start로 부터 end 까지의 날짜와 시간의 순서를 나타내는 SpinnerDateModel을 작성합니다.

메서드 개요

int	getCalendarField () nextValue 메서드 또는 previousValue 메서드에 의해 가산 또는 감산된 Calendar 필드를 리턴합니다.
Date	getDate () 이 순서의 Date 가운데, 현재의 요소를 리턴합니다.
Comparable	getEnd () 순서의 마지막 Date를 리턴합니다.
Object	getNextValue () 순서의 다음의 Date를 리턴합니다.
Object	getPreviousValue () 순서의 전의 Date를 리턴합니다.
Comparable	getStart () 순서의 선두의 Date를 리턴합니다.
Object	getValue () 이 순서의 Date 가운데, 현재의 요소를 리턴합니다.
void	setCalendarField (int calendarField) nextValue 메서드와 previousValue 메서드에 의해 계산되는 날짜와 시간치 변경의 사이즈를 변경합니다.
void	setEnd (Comparable end) 이 순서의 Date 상한을 변경합니다.
void	setStart (Comparable start) 이 순서의 Date 하한을 변경합니다.
void	setValue (Object value) 이 순서의 현재의 Date를 설정합니다.

클래스 javax.swing. AbstractSpinnerModel 로부터 상속된 메서드

addChangeListener, fireStateChanged, getChangeListeners, getListeners, removeChangeListener

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

SpinnerDateModel

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

start로 부터 end 까지의 날짜와 시간의 순서를 나타내는 SpinnerDateModel을 작성합니다. nextValue 메서드와 previousValue 메서드는 현재의 날짜와 시간인 value를 calendarField 타임 유니트 배당진 또는 후퇴 시켜, 순서의 요소를 계산합니다. Calendar field 증가 또는 감소에 대한자세한 내용은 java.util.Calendar add 메서드를 참조하십시오.

순서의 범위에 상한 또는 하한이 없는 것을 나타내기 위해서 start 파라미터와 end 파라미터를 null로 할 수 있습니다. value 또는 calendarField 이 null인 경우, 혹은 start와 end 양쪽 모두가 지정되고 있어mininum > 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) 이 false인 경우

관련 항목:

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

SpinnerDateModel

public SpinnerDateModel()

초기의 value가 현재의 값으로calendarField가 Calendar.DAY_OF_MONTH에 동일하고, start와 end에 한도가 없는 SpinnerDateModel을 구축합니다.

메서드의 상세

setStart

public void setStart(Comparable  start)

이 순서의 Date 하한을 변경합니다. start이 null인 경우, 하한은 없습니다. 여기에서는 경계의 체크는 행해지지 않습니다. 즉, 새로운 start 값이, 생성자에 의해 적용되는 불변식 (start <= value <= end)을 무효로 하는 일이 있습니다. 이것은 모델의 갱신을 단순하게 하기 때문에입니다. 당연, nextValue, previousValue, setValue 각 메서드를 호출하기 전에 불변식이 true가 되도록 할 필요가 있습니다.

보통, 이 프로퍼티는 Date 입니다만, Comparable로 Date에 대한 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);
     }
 }
 

상기의 예에서는 compareTo(Object)에 게 건네진 Object이 Date가 아닌 경우, ClassCastException가 발생 됩니다.

start이 변경되면, 이 메서드는 ChangeEvent를 트리거 합니다.

파라미터:

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)

이 순서의 Date 상한을 변경합니다. start이 null인 경우, 상한은 없습니다. 여기에서는 경계의 체크는 행해지지 않습니다. 즉, 새로운 start 값이, 생성자에 의해 적용되는 불변식 (start <= value <= end)을 무효로 하는 일이 있습니다. 이것은 모델의 갱신을 단순하게 하기 때문에입니다. 당연, nextValue, previousValue, setValue 각 메서드를 호출하기 전에 불변식이 true가 되도록 할 필요가 있습니다.

보통, 이 프로퍼티는 Date 입니다만, Comparable로 Date에 대한 compareTo 메서드를 사용할 수 있습니다. 예에 대해서는 setStart를 참조하십시오.

end가 변경되면, 이 메서드는 ChangeEvent를 트리거 합니다.

파라미터:

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.MONTH 나 Calendar.MINUTE 등, Calendar 필드의 정수의 어떤 것인가일 필요가 있습니다. nextValue 메서드와 previousValue 메서드는 지정된 Calendar 필드를, Calendar.add에 의해 1 유니트씩 전후로 이동할 뿐입니다. 일부의 UI 에서는 calendarField를 설정하고 나서, 편집을 확정해 커서아래에 있는 필드를 스핀 할 수 있기 때문에 이 메서드를 사용할 때는 주의가 필요합니다. 1 필드만을 스핀 하는 경우는 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를 리턴합니다. 다음날 부가 end 보다 나머지의 경우는 null을 리턴합니다.

정의:

인터페이스 SpinnerModel 내의 getNextValue

반환값:

순서의 다음의 Date. 다음날 부가 end 보다 나머지의 경우는 null

관련 항목:

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

getPreviousValue

public Object  getPreviousValue()

순서의 전의 Date를 리턴합니다. 전날부가 start 보다 전의 경우는 null을 리턴합니다.

정의:

인터페이스 SpinnerModel 내의 getPreviousValue

반환값:

순서의 전의 Date. 전날부가 start 보다 전의 경우는 null

관련 항목:

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

getDate

public Date  getDate()

이 순서의 Date 가운데, 현재의 요소를 리턴합니다. 이 메서드는 (Date) getValue에 상당합니다.

반환값:

value 프로퍼티

관련 항목:

setValue(java.lang.Object)

getValue

public Object  getValue()

이 순서의 Date 가운데, 현재의 요소를 리턴합니다.

정의:

인터페이스 SpinnerModel 내의 getValue

반환값:

value 프로퍼티

관련 항목:

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

setValue

public void setValue(Object  value)

이 순서의 현재의 Date를 설정합니다. value가 null인 경우, IllegalArgumentException가 발생 됩니다. 여기에서는 경계의 체크는 행해지지 않습니다. 즉, 새로운 값이, 생성자에 의해 적용되는 불변식 (start <= value <= end)을 무효로 하는 일이 있습니다. 당연, nextValue, previousValue, setValue 각 메서드를 호출하기 전에 불변식 (start <= value <= maximum) 이 true가 되도록 할 필요가 있습니다.

value가 변경되면, 이 메서드는 ChangeEvent를 트리거 합니다.

정의:

인터페이스 SpinnerModel 내의 setValue

파라미터:

value - 이 순서의 현재의 Date (null 이외)

예외:

IllegalArgumentException - value가 null인 경우, 혹은 Date가 아닌 경우

관련 항목:

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