날짜 위젯

날짜 위젯은 날짜를 선택할 때 사용하는 위젯입니다. 사용법은 날짜/시간 위젯과 비슷하며, 날짜 선택 시 보다 편리하고 향상된 UI를 제공합니다.

Methods

리턴 값	함 수	설 명
	addDays( days )	현재 설정된 날짜에 일을 더합니다.
str	format()	현재 설정된 날짜 포맷을 읽어옵니다.
str	getDateString()	위젯의 표시된 날짜를 기본 설정된 포맷형태의 문자열로 읽어옵니다.
str	getDateString( formatString )	위젯의 표시된 날짜를 입력한 포맷형태의 문자열로 얻어옵니다.
date	getDate()	위젯에 표시된 날짜를 Python date 형태로 읽어 옵니다.
datetime	getDateTime()	위젯에 표시된 날짜를 Python datetime 형태로 읽어 옵니다.
int	getDay()	위젯의 일을 얻어옵니다.
int	getMonth()	위젯의 월을 얻어옵니다.
int	getYear()	위젯의 년도를 얻어옵니다.
	setCurrentDate()	현재 날짜를 위젯에 표시합니다.
	setDate( text )	날짜를 위젯에 표시합니다.
	setDate( year, month, day )	입력한 날짜를 위젯에 표시합니다.
	setDay( day )	위젯의 일을 설정합니다.
	setFormat( text )	위젯에 날짜 표기 포맷을 설정합니다.
	setMonth( month )	위젯의 월을 설정합니다.
	setYear( year )	위젯의 년도를 설정합니다.
	setDateSelectMode( type )	위젯의 날짜 선택 모드를 설정합니다.

addDays( days:더할 일수 )

현재 설정된 날짜에 일을 더합니다.

예)

# 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

obj.setDate('2013-01-01');

# 현재 설정된 날짜에 2일을 더합니다.

obj.addDays(2)

print (obj.getDateTime( ) )

출력)

2013-01-03

setDate( text:시간문자열 )

위젯에 날짜를 설정합니다.

text는 시간문자열을 입력합니다.

예) ‘2013-01-01’

예)

# 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

obj.setDate('2013-01-01');

setDate( year:년, month:월, day:일 )

위젯에 날짜를 설정합니다.

파라미터(년, 월, 일)에 맞게 날짜가 설정됩니다.

예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

obj.setDate(2000, 12, 25);

setCurrentDate()

현재 날짜를 위젯에 표시 합니다.

예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

obj.setCurrentDate();

str getDateString( text:날짜 형식 )

위젯에 표시된 날짜를 입력한 형식에 맞게 문자열 형태로 얻어옵니다.

text를 공백으로 하여 입력할 경우 기본설정값으로 날짜를 얻어옵니다.
기본설정값 ‘yyyy-MM-dd’
text에 날짜 형식을 입력할 경우 그 형식에 맞는 날짜를 얻어옵니다.

예) 화면표시 날짜 2013-01-01 일때 ‘MM-dd’ 입력시 반환되는 문자열은 01-01 입니다.

예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

#기본 포맷으로 설정된 형태의 문자열로 읽어옵니다.

val = obj.getDateString();

app.messageBox(val);

# 현재 표시중인 날짜를 yyyy-MM-dd HH 형식의 문자열로 얻어옵니다.

val = obj.getDateString('yyyy-MM-dd HH');

app.messageBox(val);

setYear( year:년 )

setYear는 날짜 위젯의 년도를 year로 변경합니다.

예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

# 년도를 2012로 변경합니다.

obj.setYear(2012);

setMonth( month:월 )

setMonth는 날짜 위젯의 월을 month로 변경합니다.

예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

# 월을 11로 변경합니다.

obj.setMonth(11);

setDay( day:일 )

setDay는 날짜 위젯의 일을 day로 변경합니다.

예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

# 일을 22로 변경합니다.

obj.setDay(22);

int getYear()

getYear는 날짜 위젯의 화면표시 상태의 년도를 얻어옵니다.

예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

# 년도를 얻어옵니다.

val = obj.getYear();

app.messageBox(val);

int getMonth()

getMonth 는 날짜 위젯의 화면표시 상태의 월을 얻어옵니다.

예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

# 월을 얻어옵니다.

val = obj.getMonth();

app.messageBox(val);

int getDay()

getDay는 날짜 위젯의 화면표시 상태의 일을 얻어옵니다.

예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

# 일을 얻어옵니다.

val = obj.getDay();

app.messageBox(val);

setFormat( text:표시값 문자열 )

날짜 표기 형식을 설정 합니다.

text에 따라 날짜 표시 방식이 변경됩니다.
기본 표시 문자열은 ‘yyyy-MM-dd’ 로 설정되어 있습니다.

예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

obj.setFormat('yy.MM.dd');

str format()

현재 설정된 날짜 표시 형식을 읽어옵니다.

예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

# 기본 표시값 문자열을 얻어옵니다.

val = obj.format();

setDateSelectMode( type:종류 구분 )

위젯의 날짜 선택 모드를 설정합니다.

type의 종류는 일, 월, 년도 3가지입니다.

0 : 일
1 : 월
2 : 년도

예) 날짜 선택 모드를 일로 설정할 경우

# 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

obj.setDateSelectMode(0);

예) 날짜 선택 모드를 월로 설정할 경우

# 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

obj.setDateSelectMode(1);

예) 날짜 선택 모드를 년도로 설정할 경우

# 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

obj.setDateSelectMode(2);

date getDate( )

현재 설정된 날짜를 Python date 형식으로 읽어 옵니다.

예)

obj = canvas.getObject('DateTime'); #개체를 얻어옵니다.

obj.setDate('2013-01-01');

print (obj.getDate( ) )

datetime getDateTime( )

현재 설정된 날짜를 Python datetime 형식으로 읽어 옵니다.

예)

# 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

obj.setDate('2013-01-01');

print (obj.getDateTime( ) )

출력)

2013-01-01