javax.microedition.lcdui
クラス DateField

java.lang.Object
  javax.microedition.lcdui.Item
      javax.microedition.lcdui.DateField

public class DateField
extends Item

DateField は日付と時刻情報を表示しユーザーが編集可能な、Form に登録することができるユーザーインタフェース・コンポーネントです。 このフィールドの値は最初に設定することも後から設定することもできます。 値が設定されていないフィールドは、明確に値が設定されていない状態の表示を行います。 フィールドの値が「未初期化状態」の場合、getDate() メソッドは null を返します。

DateField オブジェクトは、日付または時間情報あるいはその両方を受け取ることができます。 これらの入力モードは、このクラスに定義されている DATE、TIME、DATE_TIME の各フィールドで指定します。 DATE は日付情報のみを、TIME は時間情報のみを、DATE_TIME は日付および時間情報の両方を設定できます。

入力モードが TIME の場合、Date オブジェクトの日付部分は 1970 年 1 月 1 日が設定されます。

カレンダーの計算はデフォルトのロケールに基づいてタイムゾーンが決定されます。 計算の結果および異なる入力モードの設定などにより、このフィールドに設定した値と異なる値を返すことがあります。

DATE

public static final int DATE

日付情報（年月日）用の入力モードを示す定数（=1）です。 この入力モードを指定すると日付の値のみが編集可能になります。 Date オブジェクトの時間情報は無視されます。

関連項目:

定数フィールド値

TIME

public static final int TIME

時間情報（時分）用の入力モードを示す定数（=2）です。 この入力モードを指定すると時間の値のみが編集可能になります。 Date オブジェクトの日付情報は 1970 年 1 月 1 日の値が設定されているべきであり、アクセスしてはなりません。

関連項目:

定数フィールド値

DATE_TIME

public static final int DATE_TIME

日付（年月日）および時間（時分）情報用の入力モードを示す定数（=3）です。 この入力モードを指定すると日付および時間情報の両方が編集可能になります。

関連項目:

定数フィールド値

DateField

public DateField(String label,
                 int mode)

ラベルと入力モードを受け取ってオブジェクトを構築します。 このコンストラクタの呼び出しは以下の記述と等価です。

     DateField(label, mode, null);

入力モードは DATE、TIME、DATE_TIME のいずれかで指定します。 これ以外の値を入力モードで指定すると IllegalArgumentException を throw します。

パラメータ:

label - 設定するラベル文字列を渡します。

mode - 入力モードを渡します。

例外:

IllegalArgumentException - 入力モードの指定が不適切な場合に throw します。

DateField

public DateField(String label,
                 int mode,
                 TimeZone timeZone)

カレントのロケールと指定されたタイムゾーンをベースにカレンダーの計算を行うオブジェクトを構築します。 DateField の値は、初期状態で「未初期化」状態となっています。 指定されたタイムゾーンが null の場合、システムがデフォルトで使用するタイムゾーンを使用します。

入力モードは DATE、TIME、DATE_TIME のいずれかで指定します。 これ以外の値を入力モードで指定すると IllegalArgumentException を throw します。

パラメータ:

label - 設定するラベル文字列を渡します。

mode - 入力モードを渡します。

timeZone - 設定するタイムゾーンあるいは null を渡します。

例外:

IllegalArgumentException - 入力モードの指定が不適切な場合に throw します。

getDate

public Date getDate()

このフィールドの Date 情報を返します。 フィールドが「未初期化」状態の場合、null を返します。 このメソッドが返す Date オブジェクトはフィールドに設定されているタイムゾーンおよびロケールによって調整済みです。

入力モードに TIME が指定されたフィールドの場合、このメソッドが返す Date オブジェクトの日付部分は 1970 年 1 月 1 日と設定されています。 もしもフィールドが持っている Date オブジェクトの日付部分が 1970 年 1 月 1 日より 1 日以上先を示しているか、「未初期化」状態の場合は null を返します。

入力モードに DATE が指定されたフィールドの場合、このメソッドが返す Date オブジェクトの時間部分は 0 時 0 分が設定されます。

戻り値:

date 入力モードが作用した結果の日付情報を返します。

setDate

public void setDate(Date date)

このフィールドに新しい日時を設定します。 date には null を指定することができます。 null が渡された場合、フィールドは「未初期化」状態になります。 このフィールドに設定されている入力モードは渡された Date オブジェクトをどのように取り扱うかを定義しています。

入力モードが TIME の場合、date の日付情報は無視され、フィールドは時分の情報のみを受け取ります。

入力モードが DATE の場合、date の時間情報は無視され、フィールドは年月日の情報のみを受け取ります。

入力モードが DATE_TIME の場合、フィールドは date の日時情報を分精度で受け取ります。

パラメータ:

date - 新しく設定する日時を渡します。

関連項目:

getDate()

getInputMode

public int getInputMode()

このフィールドに設定されている入力モードを返します。 有効な入力モードは DATE、TIME、DATE_TIME のいずれかです。

戻り値:

入力モードを返します。

setInputMode

public void setInputMode(int mode)

このフィールドに入力モードを設定します。 有効な入力モードは DATE、TIME、DATE_TIME のいずれかです。

パラメータ:

mode - 設定する入力モードを渡します。

例外:

IllegalArgumentException - 不適切な入力モードが指定された場合に throw します。