시작하기

설치

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.

수동 설정을 선호한다면, 다음 명령어를 실행하여 플러그인을 설치하고 아래의 플랫폼별 지침을 따르세요:

bun add @capgo/capacitor-date-picker
bunx cap sync

가져오기

import { DatePicker } from '@capgo/capacitor-date-picker';

자주 하는 실수

• 현재 사이의 기간 숨기기: 호출 hide() 사용자가 피커 하나가 열린 상태에서 다른 피커를 열 수 있는지 여부.
• ISO 문자열: 통과 date, min, 그리고 max 문서화된 문자열 형식으로 format 옵션을 설정하세요.
• 범위 유효성 검사: presentRange() 서버 측에서도 비즈니스 규칙을 적용해야 합니다. 사용자가 오프라인에서 경계 날짜를 선택할 수 있기 때문입니다.

날짜 선택

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',
});

날짜 범위 선택

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);

Picker 숨기기

await DatePicker.hide();

플랫폼 옵션

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 스타일 형식을 지원합니다.
title	다이얼로그 제목.
locale	지원되는 경우 네이티브 피커에서 사용하는 로케일.
timezone	파싱 및 포맷팅에 사용되는 타임존.
is24h	24시간제 사용.
minuteStep	시간 피커의 분 단위 간격.
doneText / cancelText	사용자 정의 액션 레이블.

예제 앱

이 저장소에는 네이티브 date picker, time picker, range picker를 여는 Capacitor 예제 앱과 hide()플러그인 버전 호출이 포함되어 있습니다.

iOS	Android

API 레퍼런스

전체 API 레퍼런스는 패키지 README와 TypeScript 정의에서 관리됩니다:

• README
• 타입 정의