메인 콘텐츠로 건너뛰기
Back to plugins
@capgo/capacitor-date-picker
튜토리얼
@capgo/capacitor-date-picker

날짜 선택

iOS, Android, Web에서 사용할 수 있는 네이티브 날짜, 시간, 날짜-시간, 년-월, 및 범위 선택기

가이드

__CAPGO_KEEP_0__에서 날짜 선택기 튜토리얼

장치에서 테스트

Capgo 앱을 다운로드하고 QR code을 스캔하세요.

Date Picker plugin preview QR code

Using @capgo/capacitor-date-picker

@capgo/capacitor-date-picker adds native date, time, date-time, year-month, and range pickers to Capacitor apps on iOS and Android, with a matching Web fallback.

This is Capgo's maintained alternative to @capacitor-community/date-picker. We listen to community reports, fix issues fast, and ship updates instead of leaving long-standing GitHub issues open.

Install

npm install @capgo/capacitor-date-picker
npx cap sync

Native Picker Demo

iOS Android
Animated iOS demo of @capgo/capacitor-date-picker opening, selecting a date, and closing Animated Android demo of @capgo/capacitor-date-picker opening, selecting a date, and closing

원생 픽커 스크린샷

iOS Android
iOS 스크린샷에서 @capgo/capacitor-date-picker이 native date picker를 보여줍니다. Android 스크린샷에서 @capgo/capacitor-date-picker이 native date picker를 보여줍니다.

날짜를 선택하세요.

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

기간을 선택하세요.

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

활성 픽커를 닫으세요.

await DatePicker.hide();

이것이 고쳐집니다.

  • Capacitor 8 지원.
  • 웹 구현과 동일 present() API.
  • 프로그램적 hide().
  • 대화 제목 지원.
  • iOS 회전 안전한 레이아웃, 지역 설정, 및 yearAndMonth 모드.
  • 안전한 날짜 파싱 및 날짜만 시간대 처리.
  • Android 중첩 옵션, is24h, 대화 레이아웃 처리 및 UI-스레드 대화 처리.
  • 분 단위 단계와 날짜 범위 선택.

전체 참조