SpinnerDateModel (Java Platform SE 8)

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`を返します。次の日付が`end`よりあとの場合は`null`を返します。
`Object`	`getPreviousValue()` シーケンスの前の`Date`を返します。前の日付が`start`より前の場合は`null`を返します。
`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の両方が指定されており、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)が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を返します。
    
    定義:
    
    getNextValue、インタフェース: SpinnerModel
    
    戻り値:
    
    シーケンスの次のDate。次の日付がendよりあとの場合はnull。
    
    関連項目:
    
    SpinnerModel.getNextValue(), getPreviousValue(), setCalendarField(int)
  - getPreviousValue
```
public Object getPreviousValue()
```
    シーケンスの前のDateを返します。前の日付がstartより前の場合はnullを返します。
    
    定義:
    
    getPreviousValue、インタフェース: SpinnerModel
    
    戻り値:
    
    シーケンスの前の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のうち、現在の要素を返します。
    
    定義:
    
    getValue、インタフェース: SpinnerModel
    
    戻り値:
    
    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をトリガーします。
    
    定義:
    
    setValue、インタフェース: SpinnerModel
    
    パラメータ:
    
    value - このシーケンスの現在のDate (null以外)
    
    例外:
    
    IllegalArgumentException - valueがnullの場合、またはDateでない場合
    
    関連項目:
    
    getDate(), getValue(), AbstractSpinnerModel.addChangeListener(javax.swing.event.ChangeListener)

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスSpinnerDateModel

フィールドのサマリー

クラス javax.swing.AbstractSpinnerModelから継承されたフィールド

コンストラクタのサマリー

メソッドのサマリー

クラス javax.swing.AbstractSpinnerModelから継承されたメソッド

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

SpinnerDateModel

SpinnerDateModel

メソッドの詳細

setStart

getStart

setEnd

getEnd

setCalendarField

getCalendarField

getNextValue

getPreviousValue

getDate

getValue

setValue