present() 날짜, 시간, 복합 모드에 대해 최소/최대값과 포맷 옵션을 갖춘 플랫폼 피커를 표시합니다. presentRange() 예약 방식의 시작 및 종료 시간 선택을 처리합니다. 하나의 TypeScript API로 iOS wheel 또는 inline 스타일과 Android Material dialog를 커스텀할 수 있습니다.
주요 활용 사례: 여행 예약, 일정 관리 양식, 생년월일 입력, 접근성 높은 네이티브 컨트롤이 필요한 필터 등.
| 플랫폼 | 지원 | 참고 사항 |
|---|
| iOS | 지원 | wheel 및 inline을 포함한 UIDatePicker 스타일 |
| Android | 지원 | Material 날짜 및 시간 피커 |
| 웹 | 지원 | 플러그인 내 폴백 피커 구현 |
| iOS | Android |
|---|
 |  |
| iOS | Android |
|---|
 |  |
- 네이티브 날짜, 시간, 날짜/시간, 년월, 카운트다운 스타일 피커를 제공합니다.
- 다음을 통해 날짜 범위를 선택하세요
presentRange().
- 반환된 값을 ISO, Java/Unicode 및 일반적인 Moment 스타일 패턴으로 포맷팅합니다.
- 지원하기
min, max, date, 로케일, 타임존, 24시간제 옵션도 지원합니다.
- 필요한 경우 플랫폼별 iOS 및 Android 옵션 블록을 사용하세요.
- 활성 피커를 코드로 닫으려면
hide().
- Capacitor 8 지원.
- 동일한
present() API.
- 다이얼로그 타이틀 지원.
- iOS 회전 대응 레이아웃 및 로케일 처리.
- iOS
yearAndMonth 모드 지원.
- 잘못된 날짜, ISO 문자열, 날짜만 있는 값에 대한 더 안전한 파싱 및
min / max.
- Android 중첩 옵션,
is24h, 다이얼로그 너비 처리 및 UI 스레드 다이얼로그 처리.
- 시간 선택기의 분 단위 간격.
- 다음을 통한 범위 선택:
presentRange().
| 기능 | iOS | Android | 웹 |
|---|
present() | 지원 | 지원 | 지원 |
presentRange() | 지원 | 지원 | 지원 |
hide() | 지원 | 지원 | 지원 |
date 모드 | 지원 | 지원 | 지원 |
time 모드 | 지원 | 지원 | 지원 |
dateAndTime 모드 | 지원 | 지원 | 지원 |
yearAndMonth 모드 | 지원 | 날짜 폴백 | 지원 |
minuteStep | 지원 | 지원 | 지원 |
| 메서드 | 설명 |
|---|
present | 단일 값을 선택할 수 있는 네이티브 또는 Web 피커를 표시합니다. |
presentRange | 날짜 범위를 선택할 수 있는 피커를 표시합니다. 네이티브 플랫폼은 두 개의 네이티브 선택 도구를 사용하며, Web은 시작 및 종료 컨트롤을 함께 표시합니다. |
hide | 현재 열려 있는 피커가 있다면 닫습니다. |
getPluginVersion | 플랫폼 구현 버전 마커를 가져옵니다. |
이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-date-picker.