시작하기

설치

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 Reference

The complete API reference is maintained in the package README and TypeScript definitions:

• README
• Type definitions