Class: MonthEditor

MonthEditor

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 객체를 선언하여 넣으면 되며, 기간을 지정할 경우에는 rangeStartrangeEnd 속성으로 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

선택할 수 있는 기간.

기간을 나타내는 객체로 rangeStartrangeEnd 속성으로 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

사용자가 선택한 날짜