new MonthEditor()
DataGrid에서 년월 편집시 표시되는 년월 선택 달력 클래스입니다.
년월로 편집을 하고자 하는 DataGridColumn의 itemEditor 속성에 "MonthEditor"로 설정을 하여 사용합니다.
- Since:
- 4.0
- See:
Members
-
dataFormatStringstring
-
데이터에서 날짜 문자열을 Date로 변환할 때 사용될 포맷 문자열.
Date.parse 함수를 통해 파싱이 안될 경우 지정하여 Date로 변환할 수 있도록 합니다. -
readonlydataTextstring
-
dataFormatString이 지정된 경우 사용자가 선택한 Date를 dataFormatString으로 변환한 값.
- See:
-
- 자바스크립트에서 사용할 때는 getter함수를 사용합니다. - getDataText()
-
disabledRangesArray
-
선택할 수 없는 월 또는 기간.
날짜를 지정할 경우 Date 객체를 선언하여 넣으면 되며, 기간을 지정할 경우에는rangeStart
와rangeEnd
속성으로 Date 객체를 넣어주면 되며, 둘 중 한 개만 있을 경우에는 나머지는 모두 선택할 수 없게 됩니다.
가령rangeStart
만 있을 경우에는 그 이후 날짜는 선택할 수 없게 되고,rangeEnd
만 있을 경우에는 그 이전 날짜는 선택할 수 없게 되는 것입니다.
예로 다음과 같이 줄 경우
[new Date(2013,10,1), {rangeStart: new Date(2014,0,1), rangeEnd: new Date(2014,1,1)}, {rangeStart: new Date(2014,3,1)}]
2013/11 월은 선택할 수 없으며 2014/01 부터 2014/02 까지와 2014/04월 이후부터는 선택할 수 없게 됩니다.
selectedMonth 설정으로 선택된 년월이 이 설정으로 선택할 수 없는 년월이 되면 selectedMonth는 null이 됩니다.- Default Value:
- []
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getDisabledRanges(), setDisabledRanges(value)
-
displayedYearnumber
-
화면에 표시할 년.
지정하지 않을 경우 현재 년이 됩니다.- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getDisplayedYear(), setDisplayedYear(value)
-
editableboolean
-
사용자의 편집가능 여부.
true로 설정할 경우 TextInput창에 직접 날짜를 입력할 수 있게 됩니다.- Default Value:
- false
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getEditable(), setEditable(value)
-
formatStringstring
-
입력창에 표시할 날짜의 형식.
날짜형식은 "YYYY", "YY", "MM"가 가능하며, 4자리 년도, 2자리 년도, 월의 의미입니다.- Default Value:
- "YYYY/MM"
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getFormatString(), setFormatString(value)
-
heightnumber
-
개체의 높이.
pixel단위로 적용됩니다.- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getHeight(), setHeight(value)
-
maxYearnumber
-
선택 가능한 마지막 년.
지정하지 않을 경우 2100입니다.- Default Value:
- 2100
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getMaxYear(), setMaxYear(value)
-
minYearnumber
-
선택 가능한 첫번째 년.
지정하지 않을 경우 1900입니다.- Default Value:
- 1900
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getMinYear(), setMinYear(value)
-
monthNamesArray
-
월의 이름들을 가지는 배열.
기본값은 리소스 관리자의 언어팩 설정에 의해 지정하게 됩니다- Default Value:
- ["1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12"]
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getMonthNames(), setMonthNames(value)
-
monthSymbolstring
-
표시되는 월 뒤에 붙여줄 문자열.
기본값은 리소스 관리자의 언어팩 설정에 의해 지정하게 됩니다- Default Value:
- "월"
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getMonthSymbol(), setMonthSymbol(value)
-
parseFunctionfunction
-
텍스트로 입력된 문자열을 Date객체로 바꾸는 파싱 함수.
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getParseFunction(), setParseFunction(value)
Example
parseFunction 함수의 파라메터는 다음과 같습니다.
function parseFunction(value, inputFormat) - value : 입력된 날짜 문자열 - inputFormat : 날짜 형식을 나타내는 포맷 문자열
-
selectableRangeobject
-
선택할 수 있는 기간.
기간을 나타내는 객체로rangeStart
와rangeEnd
속성으로 Date 객체를 넣어주면 되며,
둘 중 한 개만 있을 경우에는 나머지는 모두 선택할 수 있게 됩니다. 가령rangeStart
만 있을 경우에는 그 이후 날짜는 선택할 수 있게 되고
rangeEnd
만 있을 경우에는 그 이전 날짜는 선택할 수 있게 되는 것입니다.
예로 다음과 같이 줄 경우
{rangeStart: new Date(2014,0,1), rangeEnd: new Date(2014,1,1)}
2014/01 부터 2014/02 까지 선택할 수 있게 됩니다.
selectedMonth 설정으로 선택된 년월이 이 설정으로 선택할 수 없는 년월이 되면 selectedMonth는 null이 됩니다.- Default Value:
- null
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getSelectableRange(), setSelectableRange(value)
-
selectedMonthDate
-
선택된 년월의 날짜.
Date객체이므로 선택된 년월만 추출하여 사용합니다.- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getSelectedMonth(), setSelectedMonth(value)
-
showThisMonthboolean
-
오늘의 월을 하이라이트할지 여부.
- Default Value:
- "true"
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getShowThisMonth(), setShowThisMonth(value)
-
textstring
-
텍스트 입력창에 표시할 문자열.
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getText(), setText(value)
-
visibleboolean
-
가시성 여부.
- Default Value:
- true
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getVisible(), setVisible(value)
-
widthnumber
-
개체의 넓이.
pixel단위로 적용됩니다.- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getWidth(), setWidth(value)
-
yearSymbolstring
-
제목줄에 표시되는 년 뒤에 붙여 줄 문자열.
기본값은 리소스 관리자의 언어팩 설정에 의해 지정하게 됩니다- Default Value:
- "년"
- See:
-
- 자바스크립트에서 사용할 때는 getter, setter함수를 사용합니다. - getYearSymbol(), setYearSymbol(value)
Methods
-
close()
-
표시된 년월 달력을 닫습니다.
-
dateToString(value, inputFormat){string}
-
전달된 Date를 포맷형식에 맞춰 문자열로 변환하여 반환합니다.
Name Type Description value
Date 변환하려는 날짜
inputFormat
string 날짜 포맷 문자열
Returns:
Type Description string 변환된 날짜 문자열 -
focus()
-
포커스를 주고 년월 달력을 표시합니다.
-
invalidateDisplayList()
-
MonthEditor의 속성과 크기에 따라 객체를 다시 그립니다.
-
open()
-
년월 달력을 표시합니다.
-
stringToDate(value, inputFormat){Date}
-
전달된 문자열을 포맷형식에 맞춰 년월일 포함한 Date 객체로 변환하여 반환합니다.
Name Type Description value
string 변환하려는 날짜
inputFormat
string 날짜 포맷 문자열
Returns:
Type Description Date 변환된 날짜
Events
-
change
-
사용자가 년월을 선택하였을 때 발생합니다.
Type:
- Event
Properties:
Name Type Description newDate
Date 사용자가 선택한 날짜