javax.microedition.lcdui
Class DateField

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

public class 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

Field Summary

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

Fields inherited from class javax.microedition.lcdui.Item

BUTTON, HYPERLINK, LAYOUT_2, LAYOUT_BOTTOM, LAYOUT_CENTER, LAYOUT_DEFAULT, LAYOUT_EXPAND, LAYOUT_LEFT, LAYOUT_NEWLINE_AFTER, LAYOUT_NEWLINE_BEFORE, LAYOUT_RIGHT, LAYOUT_SHRINK, LAYOUT_TOP, LAYOUT_VCENTER, LAYOUT_VEXPAND, LAYOUT_VSHRINK, PLAIN

Constructor Summary

DateField(String label, int mode)
지정된 레이블과 모드를 사용하여 DateField 객체를 만듭니다.

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

Method Summary

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

Methods inherited from class javax.microedition.lcdui.Item

addCommand, getLabel, getLayout, getMinimumHeight, getMinimumWidth, getPreferredHeight, getPreferredWidth, notifyStateChanged, removeCommand, setDefaultCommand, setItemCommandListener, setLabel, setLayout, setPreferredSize

Methods inherited from class java.lang.Object

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

Field Detail

DATE

public static final int DATE

날짜 정보(년, 월, 일)에 대한 입력 모드. 이 모드를 사용하면 DateField는 날짜 값을 표시하고 이 값만 수정할 수 있게 합니다. 날짜 객체의 시간 정보는 무시됩니다.

1의 값이 DATE에 할당됩니다.

See Also:

Constant Field Values

TIME

public static final int TIME

시간 정보(시, 분)에 대한 입력 모드. 이 모드를 사용하면 DateField는 시간을 표시하고 이 값만 수정할 수 있게 합니다. 날짜 구성 요소는 1970년 1월 1일을 "원년" 값으로 설정해야 하며 액세스하면 안 됩니다.

2의 값이 TIME에 할당됩니다.

See Also:

Constant Field Values

DATE_TIME

public static final int DATE_TIME

날짜(년, 월, 일) 및 시간(시, 분) 정보에 대한 입력 모드. 이 모드를 사용하면 DateField는 시간 및 날짜 정보를 모두 제시하고 수정할 수 있게 합니다.

값 3이 DATE_TIME에 할당됩니다.

See Also:

Constant Field Values

Constructor Detail

DateField

public DateField(String label,
                 int mode)

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

Parameters:

label - 항목 레이블

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

Throws:

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

DateField

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

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

Parameters:

label - 항목 레이블

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

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

Throws:

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

Method Detail

getDate

public Date getDate()

이 필드의 날짜 값을 반환합니다. 필드 값이 초기화되어 있지 않은 경우 반환된 값은 null입니다. 로켈별 달력 시스템 규칙 및 정의된 표준 시간대에 따라 날짜 객체가 구성됩니다. TIME 모드 필드에서 날짜 구성 요소는 1970년 1월 1일을 "원년"으로 설정합니다. 시간을 나타내는 날짜 객체가 이 "원년"에서 하루를 초과한 경우 해당 필드는 "초기화되지 않은" 상태에 있으며 해당 메소드는 null을 반환합니다. DATE 모드에서 날짜 객체 구성 시 달력의 시간 구성 요소를 0으로 설정합니다.

Returns:

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

See Also:

setDate(java.util.Date)

setDate

public void setDate(Date date)

이 필드에 새 값을 설정합니다. 필드 상태를 "초기화되지 않은" 상태로 설정하기 위해 null을 전달할 수 있습니다. 이 필드의 입력 모드는 전달된 Date 객체에서 사용된 구성 요소를 정의합니다.

TIME 입력 모드에서 날짜 구성 요소는 1970년 1월 1일을 "원년" 값으로 설정해야 합니다. 시간을 나타내는 날짜 객체가 하루를 초과하는 경우 이 필드는 "초기화되지 않은" 상태에 있습니다. TIME 입력 모드에서 Date 객체의 날짜 구성 요소는 무시되며 시간 구성 요소는 분을 정확하게 표현하기 위해서 사용됩니다.

DATE 입력 모드에서 Date 객체의 시간 구성 요소는 무시됩니다.

DATE_TIME 입력 모드에서 Date의 날짜와 시간 구성 요소는 분을 정확하게 표현하기 위해서만 사용됩니다.

Parameters:

date - 이 필드의 새 값

See Also:

getDate()

getInputMode

public int getInputMode()

이 날짜 필드의 입력 모드를 가져옵니다. 유효한 입력 모드는 DATE, TIME 및 DATE_TIME입니다.

Returns:

이 필드의 입력 모드

See Also:

setInputMode(int)

setInputMode

public void setInputMode(int mode)

이 날짜 필드의 입력 모드를 설정합니다. 유효한 입력 모드는 DATE, TIME 및 DATE_TIME입니다.

Parameters:

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

Throws:

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

See Also:

getInputMode()