시작하기
이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 명령어를 복사하세요.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-date-picker`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/date-picker/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
설치
설치AI-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. 다음 명령어를 사용하여 AI 도구에 Capgo 기능을 추가하세요:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins다음 명령어를 사용하여 다음 프롬프트를 사용하세요:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-date-picker` plugin in my project.만약 Manual Setup을 선호한다면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래의 플랫폼별 지침을 따르세요:
npm install @capgo/capacitor-date-pickernpx cap syncimport { DatePicker } from '@capgo/capacitor-date-picker';날짜를 선택하세요
날짜를 선택하세요const result = await DatePicker.present({ mode: 'date', date: '2026-05-27', min: '2026-01-01', max: '2026-12-31', format: 'yyyy-MM-dd', title: 'Select date',});
console.log(result.value);시간을 선택하세요
날짜와 시간을 선택하세요const result = await DatePicker.present({ mode: 'time', is24h: true, minuteStep: 15, format: 'HH:mm', title: 'Select time',});
console.log(result.value);날짜와 시간을 선택하세요
클립보드에 복사const result = await DatePicker.present({ mode: 'dateAndTime', date: '2026-05-27T14:30:00', format: "yyyy-MM-dd'T'HH:mm:ss", title: 'Select date and time',});클립보드에 복사
기간을 선택하세요const result = await DatePicker.present({ mode: 'yearAndMonth', date: '2026-05-01', format: 'yyyy-MM', title: 'Select month',});기간을 선택하세요
Section titled “Range를 선택하세요”const range = await DatePicker.presentRange({ start: '2026-05-01', end: '2026-05-27', format: 'yyyy-MM-dd', startTitle: 'Start date', endTitle: 'End date',});
console.log(range.start, range.end, range.value);Section titled “숨기기”
Section titled “숨기기”await DatePicker.hide();플랫폼 옵션
Section titled “플랫폼 옵션”await DatePicker.present({ mode: 'date', date: '2026-05-27', title: 'Select date', ios: { style: 'inline', theme: 'light', }, android: { theme: 'light', },});| 옵션 | 설명 |
|---|---|
mode | date, time, dateAndTime, yearAndMonth, countDownTimer또는 range. |
date | 초기 선택된 값. |
min / max | 선택 가능한 최소 및 최대 값. |
format | 출력 형식. ISO, Java/Unicode 및 일반적인 Moment-style 형식이 지원됩니다. |
title | 대화 제목. |
locale | 자연 언어 선택기에서 지원되는 경우 사용되는 지역. |
timezone | 날짜 및 시간을 파싱하고 형식화하는 데 사용되는 시간대. |
is24h | 24시간 형식이 선호됩니다. |
minuteStep | 분 단위의 시간 선택기 간격. |
doneText / cancelText | 사용자 정의 액션 레이블. |
예제 앱
제목이 “예제 앱”인 섹션The repository includes a Capacitor example app that opens the native date picker, time picker, range picker, and plugin version calls. hide()iOS
| Android | __CAPGO_KEEP_0__ iOS demo of __CAPGO_KEEP_1__-date-picker opening, selecting a date, and closing |
|---|---|
![]() | ![]() |
API Reference
The complete API reference is maintained in the package README and TypeScript definitions:The complete API reference is maintained in the package README and TypeScript definitions:

