Class DateField

package javax.microedition.lcdui

java.lang.Object
  |
  +--javax.microedition.lcdui.Item
        |
        +--javax.microedition.lcdui.DateField

설명

extends Item:

DateField는 Form에 넣을 수 있는 날짜와 시간(달력) 정보를 나타내기 위한 편집 가능한 구성 요소입니다. 이 필드에 대한 값은 처음에 설정하거나 설정하지 않은 상태로 둘 수 있습니다. 값이 설정되어 있지 않으면 이 필드의 UI에 분명히 표시됩니다. “초기화되지 않은 상태”에 대한 필드 값은 유효한 값이 아니며 이 상태에 대한 getDate()는 null을 반환합니다.

날짜나 시간 정보 또는 두 가지를 모두 받아들이도록 DateField의 인스턴스를 구성할 수 있습니다. 입력 모드는 이 클래스의 DATE, TIME 또는 DATE_TIME 정적 필드로 구성됩니다. DATE 입력 모드를 사용하면 날짜 정보만 설정할 수 있으며 TIME 입력 모드를 사용하면 시간 정보(시, 분)만 설정할 수 있지만 DATE_TIME을 사용하면 시간과 날짜 값을 모두 설정할 수 있습니다.

TIME 입력 모드에서 Date 객체의 날짜 구성 요소는 1970년 1월 1일을 “원년” 값으로 설정해야 합니다.

이 필드의 달력 계산은 기본 로켈 및 정의된 표준 시간대를 기반으로 합니다. 계산 및 다양한 입력 모드로 인해 날짜 객체를 이 필드로 설정한 다음 이 필드에서 값을 다시 가져오면 같은 밀리초 값을 포함하지 않습니다.

Since:

• MIDP 1.0

필드 요약

• static int DATE — 날짜 정보(년, 월, 일)에 대한 입력 모드.
• static int DATE_TIME — 날짜(년, 월, 일) 및 시간(시, 분) 정보에 대한 입력 모드.
• static int TIME — 시간 정보(시, 분)에 대한 입력 모드.

생성자 요약

• DateField ( String label, int mode) 지정된 레이블과 모드를 사용하여 DateField 객체를 만듭니다.
• DateField ( String label, int mode, TimeZone timeZone) 특정 TimeZone 객체 및 현재 로켈의 기본 달력 시스템을 기반으로 달력을 계산하는 날짜 필드를 만듭니다.

메서드 요약

• Date getDate () — 이 필드의 날짜 값을 반환합니다.
• int getInputMode () — 이 날짜 필드의 입력 모드를 가져옵니다.
• void setDate ( Date date) — 이 필드에 새 값을 설정합니다.
• void setInputMode (int mode) — 이 날짜 필드의 입력 모드를 설정합니다.

필드 상세

DATE

public static final int DATE

See Also:

• Constant Field Values

TIME

public static final int TIME

See Also:

• Constant Field Values

DATE_TIME

public static final int DATE_TIME

See Also:

• Constant Field Values

DateField

public DateField(String label,
                 int mode)

• 지정된 레이블과 모드를 사용하여 DateField 객체를 만듭니다. 이 호출은 DateField(label, mode, null)에 대한 호출과 동일합니다.

Parameters:

• mode - 입력 모드, DATE, TIME, DATE_TIME 중 하나

Throws:

• IllegalArgumentException - 입력 mode 값이 유효하지 않은 경우

DateField

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

• 특정 TimeZone 객체 및 현재 로켈의 기본 달력 시스템을 기반으로 달력을 계산하는 날짜 필드를 만듭니다. DateField의 값은 처음에는 “초기화되지 않은” 상태에 있습니다. timeZone이 null인 경우 시스템의 기본 표준 시간대가 사용됩니다.

Parameters:

• timeZone - 특정 표준 시간대, 또는 기본 표준 시간대에 대해서는 null

Throws:

• IllegalArgumentException - 입력 mode의 값이 유효하지 않은 경우

getDate

public Date getDate()

Returns:

• 입력 모드에 따라 시간이나 날짜를 나타내는 날짜 객체

See Also:

• setDate(java.util.Date)

setDate

public void setDate(Date date)

Parameters:

• date - 이 필드의 새 값

See Also:

• getDate()

getInputMode

public int getInputMode()

Returns:

• 이 필드의 입력 모드

See Also:

• setInputMode(int)

setInputMode

public void setInputMode(int mode)

Parameters:

• mode - 입력 모드는 DATE, TIME, DATE_TIME 중 하나여야 합니다.

Throws:

• IllegalArgumentException - 유효하지 않은 값이 지정된 경우

See Also:

• getInputMode()

생성자 상세

DateField

public DateField(String label,
                 int mode)

• 지정된 레이블과 모드를 사용하여 DateField 객체를 만듭니다. 이 호출은 DateField(label, mode, null)에 대한 호출과 동일합니다.

Parameters:

• mode - 입력 모드, DATE, TIME, DATE_TIME 중 하나

Throws:

• IllegalArgumentException - 입력 mode 값이 유효하지 않은 경우

DateField

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

• 특정 TimeZone 객체 및 현재 로켈의 기본 달력 시스템을 기반으로 달력을 계산하는 날짜 필드를 만듭니다. DateField의 값은 처음에는 “초기화되지 않은” 상태에 있습니다. timeZone이 null인 경우 시스템의 기본 표준 시간대가 사용됩니다.

Parameters:

• timeZone - 특정 표준 시간대, 또는 기본 표준 시간대에 대해서는 null

Throws:

• IllegalArgumentException - 입력 mode의 값이 유효하지 않은 경우

getDate

public Date getDate()

Returns:

• 입력 모드에 따라 시간이나 날짜를 나타내는 날짜 객체

See Also:

• setDate(java.util.Date)

setDate

public void setDate(Date date)

Parameters:

• date - 이 필드의 새 값

See Also:

• getDate()

getInputMode

public int getInputMode()

Returns:

• 이 필드의 입력 모드

See Also:

• setInputMode(int)

setInputMode

public void setInputMode(int mode)

Parameters:

• mode - 입력 모드는 DATE, TIME, DATE_TIME 중 하나여야 합니다.

Throws:

• IllegalArgumentException - 유효하지 않은 값이 지정된 경우

See Also:

• getInputMode()

메서드 상세

getDate

public Date getDate()

Returns:

• 입력 모드에 따라 시간이나 날짜를 나타내는 날짜 객체

See Also:

• setDate(java.util.Date)

setDate

public void setDate(Date date)

Parameters:

• date - 이 필드의 새 값

See Also:

• getDate()

getInputMode

public int getInputMode()

Returns:

• 이 필드의 입력 모드

See Also:

• setInputMode(int)

setInputMode

public void setInputMode(int mode)

Parameters:

• mode - 입력 모드는 DATE, TIME, DATE_TIME 중 하나여야 합니다.

Throws:

• IllegalArgumentException - 유효하지 않은 값이 지정된 경우

See Also:

• getInputMode()