@capgo/capacitor-date-picker

Overview

present() shows the platform picker for date, time, or combined modes with min, max, and formatting options. presentRange() handles booking style start and end selection. Customize iOS wheel or inline styles and Android Material dialogs from one TypeScript API.

Typical fits: travel booking, scheduling forms, birth date capture, and filters that need an accessible native control.

Platform support

Platform	Support	Notes
iOS	Yes	UIDatePicker styles including wheels and inline
Android	Yes	Material date and time pickers
Web	Yes	Fallback picker implementation in the plugin

Demo

iOS	Android

Screenshots

iOS	Android

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

• Capacitor 8 support.
• Web implementation with the same present() API.
• Dialog title support.
• iOS rotation-safe layout and locale handling.
• iOS yearAndMonth mode.
• 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

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

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

This reference is synced from src/definitions.ts in capacitor-date-picker.