Date picker

캘린더를 통해 특정 날짜를 선택할 수 있게 해주는 요소로 월 단위 탐색, 연도 선택, 오늘 날짜 표시 등의 기능을 제공하며, 날짜 형식 오류를 방지하고 일관된 데이터 입력을 보장합니다.

WantedDatePicker

날짜를 선택할 수 있는 DatePicker 다이얼로그를 제공합니다. 사용자는 날짜를 선택하고 확인 또는 취소할 수 있으며, 선택된 날짜는 콜백을 통해 전달됩니다. 내부적으로 Material 3의 DatePickerDialogDatePicker 컴포넌트를 사용하여 구성됩니다.

WantedDatePicker(
    confirm = "확인",
    cancel = "취소",
    onDateSelected = { selectedDate ->
        // 선택된 날짜 처리
    },
    onDismiss = {
        // 다이얼로그 닫기 처리
    }
)

Parameters

이름타입설명
confirmString확인 버튼에 표시할 텍스트입니다.
cancelString취소 버튼에 표시할 텍스트입니다.
datePickerStateDatePickerState선택된 날짜 및 UI 상태를 관리하는 상태 객체입니다. 기본값은 rememberDatePickerState()입니다.
dateFormatterDatePickerFormatter날짜 포맷터로, 선택된 날짜의 포맷을 지정합니다. 기본값은 DatePickerDefaults.dateFormatter()입니다.
onDateSelected(Long?) -> Unit날짜 선택 완료 시 호출되는 콜백입니다. 선택된 날짜의 Unix 타임스탬프(Long) 또는 null이 전달됩니다.
onDismiss() -> Unit다이얼로그가 닫힐 때 호출되는 콜백입니다.

Advanced

WantedDatePickerWheel

연도 및 월을 선택할 수 있는 휠 형태의 날짜 선택 모달입니다. 사용자는 연도와 월을 각각 NumberPicker를 통해 선택할 수 있으며, 확인/취소 버튼을 통해 선택 값을 확정하거나 취소할 수 있습니다. 선택된 연도와 월은 콜백을 통해 반환되며, 기본 설정값은 WantedDatePickerWheelDefaults.getDefault()를 통해 조절 가능합니다.

WantedDatePickerWheel(
    title = "날짜 선택",
    confirm = "확인",
    cancel = "취소",
    selectedYear = 2023,
    selectedMonth = 1,
    onSelect = { year, month ->
        // 선택된 연도 및 월 처리
    },
    onDismissRequest = {
        // 모달 닫힘 처리
    }
)
Parameters
이름타입설명
titleString다이얼로그 상단에 표시될 제목 텍스트입니다.
confirmString확인 버튼 텍스트입니다.
cancelString취소 버튼 텍스트입니다.
selectedYearInt초기 선택된 연도입니다.
selectedMonthInt초기 선택된 월입니다.
modifierModifier외형을 설정하는 Modifier입니다.
defaultWantedDatePickerWheelDefault날짜 휠 설정을 지정하는 기본값 객체입니다.
onSelect(Int, Int) -> Unit날짜 선택 후 확인 버튼을 눌렀을 때 호출되는 콜백입니다.
onDismissRequest() -> Unit다이얼로그가 닫힐 때 호출되는 콜백입니다.

WantedDatePickerWheelDefault

날짜 선택 휠(DatePickerWheel)의 기본 설정 값을 담는 데이터 클래스입니다. 연도와 월 범위, 사용 가능한 최소/최대 값, 비활성 날짜 표시 여부를 지정할 수 있습니다.

Properties
이름타입설명
startYearInt휠에 표시할 시작 연도입니다.
endYearInt휠에 표시할 종료 연도입니다.
enableMinYearInt선택 가능한 최소 연도입니다.
enableMaxYearInt선택 가능한 최대 연도입니다.
enableMinMonthInt선택 가능한 최소 월입니다.
enableMaxMonthInt선택 가능한 최대 월입니다.
isHideDisableDateBoolean비활성 날짜를 숨길지 여부입니다.

WantedDatePickerWheelDefaults

날짜 선택 휠의 기본 설정을 제공하는 객체입니다. 유효하지 않은 값은 자동으로 보정되며, WantedDatePickerWheelDefault 객체를 생성합니다.

getDefault

날짜 선택 휠 기본 설정 값을 반환합니다. 연도 및 월 범위 설정, 비활성 날짜 숨김 여부 등을 지정할 수 있으며, 유효하지 않은 값은 자동으로 보정됩니다. 날짜 선택 휠에서 사용되는 기본 설정 객체인 WantedDatePickerWheelDefault를 생성합니다.

val default = WantedDatePickerWheelDefaults.getDefault(
    startYear = 2000,
    endYear = 2030,
    enableMinYear = 2010,
    enableMaxYear = 2025,
    enableMinMonth = 3,
    enableMaxMonth = 11,
    isHideDisableDate = true
)
Parameters
이름타입설명
startYearInt휠 선택기에서 표시할 시작 연도입니다. 기본값은 1900입니다.
endYearInt휠 선택기에서 표시할 종료 연도입니다. 기본값은 2100입니다. startYear보다 작으면 자동으로 startYear로 보정됩니다.
enableMinYearInt선택 가능한 최소 연도입니다. 기본값은 1900입니다.
enableMaxYearInt선택 가능한 최대 연도입니다. enableMinYear보다 작으면 자동으로 enableMinYear로 보정됩니다.
enableMinMonthInt선택 가능한 최소 월입니다. 기본값은 1월입니다.
enableMaxMonthInt선택 가능한 최대 월입니다. enableMinMonth보다 작으면 자동으로 enableMinMonth로 보정됩니다.
isHideDisableDateBoolean선택 불가능한 날짜를 숨길지 여부를 설정합니다. 기본값은 false입니다.

Return
타입설명
WantedDatePickerWheelDefault설정된 날짜 선택 휠 기본값 객체입니다.

© 2026 Wanted Lab, Inc.