시작하기

설치

AI-assisted 설치를 사용하여 플러그인을 설치할 수 있습니다. Capgo 스킬을 AI 도구에 추가하려면 다음 명령어를 사용하세요:

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-picker
npx cap sync

Import

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

__CAPGO_KEEP_0__

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

픽커 숨기

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-style 형식이 지원됩니다.
title	대화 상자 제목.
locale	국가코드를 사용하는 원시 선택기에서 지원되는 경우 사용하는 국가코드.
timezone	시간대 사용하여 파싱 및 형식화.
is24h	24시간 형식 사용.
minuteStep	시간 선택기 분 간격.
doneText / cancelText	사용자 정의 액션 레이블.

예제 앱

저장소에는 Capacitor 예시 앱이 포함되어 있습니다. 이 앱은 네이티브 날짜 선택기, 시간 선택기, 범위 선택기를 열고, 플러그인 버전을 호출합니다. hide(), 그리고 플러그인 버전 호출.

iOS	Android

API 참조

API 참조는 패키지 README 및 TypeScript 정의에서 완전히 유지됩니다.

• README
• 타입 정의