날짜 시간 위젯은 날짜와 시간을 설정 할 때 사용하는 위젯입니다. 연, 월, 일, 시, 분, 초 로 구성되어 있으며 전체를 설정하거나 가져오기, 개별적인 시각변경이나 가져오기가 가능합니다.


 


 

Methods


리턴 값

함 수

설 명

str

format()

시각표시 위젯의 표시 값 문자열을 얻어옵니다.

str

getDateTimeString( formatString )

시각표시 위젯의 표시된 시각을 얻어옵니다.

int

getDay()

시각표시 위젯의 일을 얻어옵니다.

int

getHour()

시각표시 위젯의 시간을 얻어옵니다.

int

getMinute()

시각표시 위젯의 분을 얻어옵니다.

int

getMonth()

시각표시 위젯의 월을 얻어옵니다.

int

getYear()

시각표시 위젯의 년도를 얻어옵니다.

int

getSecond()

시각표시 위젯의 초를 얻어옵니다.


setCurrentDateTime()

시각표시 위젯의 시각을 현재 시각으로 설정합니다.


setDateTime( text )

시각표시 위젯의 시각을 설정합니다.


setDateTime( year, month, day, hour, minute, second )

시각표시 위젯의 시각을 설정합니다.


setDay( day )

시각표시 위젯의 일을 설정합니다.


setFormat( text )

시각표시 위젯의 날짜/시간 표시 형식을 설정합니다.


setHour( hour )

시각표시 위젯의 시간을 설정합니다.


setMinute( minute )

시각표시 위젯의 분을 설정합니다.


setMonth( month )

시각표시 위젯의 월을 설정합니다.


setSecond( second )

시각표시 위젯의 초를 설정합니다.


setYear( year )

시각표시 위젯의 년도를 설정합니다.



 

 setDateTime( text:시간문자열 )

 

 setDateTime은 시각표시 위젯의 시각을 설정합니다.


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

          예)  ‘2013-01-01 11:11:11’


 예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

obj.setDateTime('2013-01-01 11:11:11');


 



 

 setDateTime( year:년, month:월, day:일, hour:시간, minute:분, second:초 )

 

 setDateTime은 시각표시 위젯의 시각을 설정합니다.


  • 파라미터에 년, 월, 일, 시, 분, 초에 맞는 숫자를 입력하면 해당 숫자에 맞는 날짜가 시각표시 위젯에 입력되고 표현됩니다.


 예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

obj.setDateTime(2000, 12, 25, 18, 55, 44);


 



 

 setCurrentDateTime()

 

 setCurrentDateTime 은 시각표시 위젯의 시각을 현재 시간으로 설정합니다.


 예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

obj.setCurrentDateTime();


 



 

 str getDateTimeString( text:날짜 형식 )

 

 getDateTimeString은 현재 화면에 표시중인 시각을 문자열 형태로 얻어옵니다.


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

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


 예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');  


# 현재 표시중인 시각을 기본 설정값 형식의 문자열로 얻어옵니다.

val = obj.getDateTimeString();  

app.messageBox(val);


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

val = obj.getDateTimeString('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);


 




 setHour( hour:시간 )

 

 setHour는 날짜 위젯의 시간을 hour로 변경합니다.


 예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

# 시를 5로 변경합니다.

obj.setHour(5);


 



 

 setMinute( minute:분 )

 

 setMinute는 날짜 위젯의 분을 minute로 변경합니다.


 예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

# 분을 15로 변경합니다.

obj.setMinute(15);


 




 setSecond( second:초 )

 

 setSecond는 날짜 위젯의 초를 second으로 변경합니다.


 예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

# 초를 25로 변경합니다.

obj.setSecond(25);


 



 

 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);


 



 

 int getHour()

 

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


 예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

# 시간을 얻어옵니다.

val = obj.getHour();

app.messageBox(val);


 



 

 int getMinute()

 

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


 예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

# 분을 얻어옵니다.

val = obj.getMinute();

app.messageBox(val);


 



 

 int getSecond()

 

 getSecond는 날짜 위젯의 화면표시 상태의 초를 얻어옵니다.


 예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

# 초를 얻어옵니다.

val = obj.getSecond();

app.messageBox(val);


 



 

 setFormat( text:표시값 문자열 )

 

 setFormat은 날짜 위젯의 표시값 문자열을 설정합니다.


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


 예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

obj.setFormat('yy.MM.dd HH-mm-ss');


 



 

 str format()

 

 format은 날짜 위젯의 표시값 문자열을 얻어옵니다.


 예)

# dateTimeWidget 개체를 얻어옵니다.

obj = canvas.getObject('DateTime');

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

val = obj.format();  

app.messageBox(val);

obj.setFormat('yy.MM.dd HH-mm-ss');

# 변경된 표시값 문자열을 얻어옵니다.

val = obj.format();  

app.messageBox(val);