본문 바로가기
@capgo/capacitor-date-picker Device API 오픈 소스

날짜 선택기 Capacitor 플러그인

iOS, Android, Web을 위한 네이티브 날짜, 시간, 날짜-시간, 년월, 범위 선택기

설치

bun add @capgo/capacitor-date-picker bunx cap sync
npm, pnpm 또는 yarn
  • npm install @capgo/capacitor-date-picker
  • pnpm add @capgo/capacitor-date-picker
  • yarn add @capgo/capacitor-date-picker

가이드

Capacitor에서 Date Picker 사용법

기기에서 테스트하기

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

Date Picker 플러그인 미리보기 QR code

@capgo/capacitor-date-picker 사용하기

@capgo/capacitor-date-picker iOS 및 Android의 Capacitor 앱에 네이티브 날짜, 시간, 날짜-시간, 년-월, 범위 선택기를 추가하며, Web 환경을 위한 폴백도 지원합니다.

이것은 Capgo에서 관리하는 @capacitor-community/date-picker의 대안입니다. 커뮤니티 피드백을 경청하고 문제를 빠르게 해결하며, GitHub 이슈를 방치하는 대신 지속적으로 업데이트를 배포합니다.

설치

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

Native Picker 데모

iOS Android
@capgo/capacitor-date-picker가 열리고, 날짜를 선택한 후 닫히는 iOS 애니메이션 데모 @capgo/capacitor-date-picker가 열리고, 날짜를 선택한 후 닫히는 Android 애니메이션 데모

Native Picker 스크린샷

iOS Android
네이티브 date picker를 보여주는 @capgo/capacitor-date-picker의 iOS 스크린샷 네이티브 date picker를 보여주는 @capgo/capacitor-date-picker의 Android 스크린샷

날짜 선택

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

활성화된 Picker 닫기

await DatePicker.hide();

수정 사항

  • Capacitor 8 지원.
  • 동일한 present() API.
  • 프로그래밍 방식의 hide().
  • 다이얼로그 타이틀 지원.
  • iOS 회전 대응 레이아웃, 로케일 처리 및 yearAndMonth 모드 지원.
  • 더 안전한 날짜 파싱 및 날짜 전용 타임존 처리.
  • Android 중첩 옵션, is24h, 다이얼로그 레이아웃 처리 및 UI 스레드 다이얼로그 처리.
  • 분 단위 간격 및 날짜 범위 선택.

전체 레퍼런스

자주 묻는 질문

Date Picker 플러그인 FAQ

Capacitor 앱에 Date Picker 플러그인을 어떻게 설치하나요?

"bun add @capgo/capacitor-date-picker" (또는 "npm install @capgo/capacitor-date-picker")를 실행한 다음, "bunx cap sync"를 실행하여 iOS 및 Android 프로젝트가 네이티브 code를 반영하도록 합니다. 앱의 code에서 "@capgo/capacitor-date-picker"를 통해 임포트하세요.

@capgo/capacitor-date-picker가 React, Vue, Angular와 호환되나요?

네. Date Picker는 Capacitor 패키지이므로 Ionic, React, Vue, Angular, Svelte 및 일반 JavaScript를 포함하여 Capacitor 내에서 실행되는 모든 웹 프레임워크와 호환됩니다.

@capgo/capacitor-date-picker은 어떤 Capacitor 버전을 지원하나요?

Capgo 플러그인은 Capacitor의 메이저 버전을 따릅니다. 사용 중인 Capacitor 메이저 버전과 일치하는 플러그인 메이저 버전을 사용하세요 (예: Capacitor 8에는 플러그인 v8). 유지 관리되는 버전은 GitHub README의 호환성 표에서 확인할 수 있습니다.

@capgo/capacitor-date-picker는 무료 오픈 소스인가요?

네. code 소스 코드는 GitHub의 https://github.com/Cap-go/capacitor-date-picker/에서 공개되어 있으며, npm를 통해 무료로 설치할 수 있습니다. 버그 리포트와 Pull Request를 언제든 환영합니다.

App Store 심사 없이 Date Picker를 사용하는 code를 업데이트할 수 있나요?

플러그인을 설치하거나 업그레이드하면 네이티브 code가 변경되므로 새로운 스토어 빌드가 필요합니다. 그 이후에는 플러그인을 호출하는 JavaScript, HTML, CSS 변경 사항을 Capgo live updates로 즉시 배포할 수 있습니다.

앱 심사 대기 없이 Date Picker 변경 사항을 즉시 배포하세요

스토어 빌드에 플러그인이 포함되면, Capgo live updates로 JavaScript, HTML, CSS 변경 사항을 몇 분 만에 사용자에게 푸시할 수 있습니다.

Capgo로 시작하기