본문으로 건너뛰기

DatePicker (데이트피커) Widget Control

DatePicker(데이트피커) 위젯을 스크립트에서 제어할 때 사용하는 Widget Control(Property · Method · Event) 목록입니다. 위젯 소개와 사용법은 DatePicker 문서를 참고하세요.

정보

아래 예시의 datepickerID는 캔버스에서 DatePicker 위젯에 지정한 이름(ID)입니다. 스크립트에서는 위젯ID.멤버 형태로 접근합니다.

Widget Control 요약​

Widget Control종류시그니처설명
selectedDatePropertydatepickerID.selectedDate현재 선택된 날짜를 yyyyMMdd 문자열로 읽기 (읽기 전용)
onDateSelectedEventdatepickerID.onDateSelected = (date) => { ... }사용자가 피커에서 날짜를 확정했을 때 실행

Property​

selectedDate​

현재 선택된 날짜를 yyyyMMdd 형식의 문자열로 반환합니다. 선택된 날짜가 없으면 빈 문자열('')을 반환합니다.

  • 종류: Property (읽기 전용)
  • 타입: 문자열 (yyyyMMdd, 예: 20260714)
  • Returns: 선택된 날짜 문자열, 미선택 시 ''

Example

const date = datepickerID.selectedDate;
if (date !== '') {
  // date 예: "20260714"
}

Method​

정보

해당 없음 - DatePicker 위젯에는 전용 Method가 없습니다. 아래 공통 Widget Control을 사용합니다.

Event​

onDateSelected​

피커에서 사용자가 날짜를 확정하면 실행됩니다. 콜백은 확정된 날짜를 인자로 받습니다.

  • 종류: Event
  • 핸들러: date 인자를 받는 콜백 함수
  • Parameters: date - 확정된 날짜 (yyyyMMdd 문자열, 예: 20260714)
  • Returns: 없음

Example

datepickerID.onDateSelected = (date) => {
  // date 예: "20260714"
};

공통 Widget Control (모든 위젯)​

노트

모든 위젯은 setProperty / getProperty / setStyleProperty 같은 이름 기반 공통 Widget Control(Method)을 사용할 수 있습니다. 공통 레퍼런스 문서(작성 예정)를 참고하세요.