본문으로 건너뛰기
백으로 돌아가기
@capgo/capacitor-date-picker
튜토리얼
@capgo/capacitor-date-picker

날짜 선택기

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

가이드

__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

Native Picker Screenshots

iOS Android
iOS @capgo/capacitor-date-picker의 네이티브 날짜 선택기 Android @capgo/capacitor-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-스레드 대화 처리.
  • 분 단위 단계 및 날짜 범위 선택.

전체 참조