@capgo/capacitor-date-picker
Native date, time, date-time, year-month, and range pickers for Capacitor apps, with a maintained Web fallback.
Overview
Section titled “Overview”@capgo/capacitor-date-picker gives Capacitor apps a native picker API for dates, times, date-time values, year-month values, and date ranges. It uses UIDatePicker on iOS, platform dialogs on Android, and native browser inputs on Web.
This is Capgo’s maintained alternative to @capacitor-community/date-picker. The difference is maintenance speed: we listen to community reports, fix issues fast, and ship updates instead of leaving long-standing GitHub issues open.
| iOS | Android |
|---|---|
 |  |
Screenshots
Section titled “Screenshots”| iOS | Android |
|---|---|
 |  |
Core Capabilities
Section titled “Core Capabilities”- Present native date, time, date-time, year-month, and countdown-style pickers.
- Select date ranges through
presentRange(). - Format returned values with ISO, Java/Unicode, and common Moment-style patterns.
- Apply
min,max,date, locale, timezone, and 24-hour time options. - Use platform-specific iOS and Android option blocks when needed.
- Close an active picker programmatically with
hide().
Community Fixes
Section titled “Community Fixes”- Capacitor 8 support.
- Web implementation with the same
present()API. - Dialog title support.
- iOS rotation-safe layout and locale handling.
- iOS
yearAndMonthmode. - Safer parsing for invalid dates, ISO strings, date-only values, and
min/max. - Android nested options,
is24h, dialog width handling, and UI-thread dialog handling. - Minute steps for time pickers.
- Range selection via
presentRange().
Platform Support
Section titled “Platform Support”| Feature | iOS | Android | Web |
|---|---|---|---|
present() | Yes | Yes | Yes |
presentRange() | Yes | Yes | Yes |
hide() | Yes | Yes | Yes |
date mode | Yes | Yes | Yes |
time mode | Yes | Yes | Yes |
dateAndTime mode | Yes | Yes | Yes |
yearAndMonth mode | Yes | Date fallback | Yes |
minuteStep | Yes | Yes | Yes |
Public API
Section titled “Public API”| Method | Description |
|---|---|
present | Present a native or Web picker for a single value. |
presentRange | Present a date range picker. Native platforms use two native selections; Web shows start and end controls together. |
hide | Close the currently visible picker, if any. |
getPluginVersion | Get the platform implementation version marker. |
Source Of Truth
Section titled “Source Of Truth”This reference is synced from src/definitions.ts in capacitor-date-picker.