Erste Schritte

Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-date-picker`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/date-picker/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Installieren

Du kannst unser KI-gestütztes Setup nutzen, um das Plugin zu installieren. Füge die Capgo Skills mit dem folgenden Befehl deinem KI-Tool hinzu:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Nutze dann diesen Prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-date-picker` plugin in my project.

Wenn du ein manuelles Setup bevorzugst, installiere das Plugin mit den folgenden Befehlen und befolge die plattformspezifischen Anweisungen unten:

bun add @capgo/capacitor-date-picker
bunx cap sync

Importieren

import { DatePicker } from '@capgo/capacitor-date-picker';

Häufige Stolperfallen

Zwischen Geschenken verstecken: aufrufen hide() ob Nutzer einen weiteren Picker öffnen können, während einer sichtbar ist.
ISO-Strings: übergeben date, min, und max im dokumentierten String-Format für Ihren format Option.
Bereichsvalidierung: presentRange() sollte Business-Regeln auch serverseitig durchsetzen, da Nutzer offline Grenzdaten wählen können.

Datum auswählen

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

Uhrzeit auswählen

const result = await DatePicker.present({
  mode: 'time',
  is24h: true,
  minuteStep: 15,
  format: 'HH:mm',
  title: 'Select time',
});

console.log(result.value);

Datum und Uhrzeit auswählen

const result = await DatePicker.present({
  mode: 'dateAndTime',
  date: '2026-05-27T14:30:00',
  format: "yyyy-MM-dd'T'HH:mm:ss",
  title: 'Select date and time',
});

Monat auswählen

const result = await DatePicker.present({
  mode: 'yearAndMonth',
  date: '2026-05-01',
  format: 'yyyy-MM',
  title: 'Select month',
});

Zeitraum auswählen

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, range.value);

Picker ausblenden

await DatePicker.hide();

Plattformoptionen

await DatePicker.present({
  mode: 'date',
  date: '2026-05-27',
  title: 'Select date',
  ios: {
    style: 'inline',
    theme: 'light',
  },
  android: {
    theme: 'light',
  },
});

Allgemeine Optionen

Option	Beschreibung
`mode`	`date`, `time`, `dateAndTime`, `yearAndMonth`, `countDownTimer`, oder `range`.
`date`	Anfangs ausgewählter Wert.
`min` / `max`	Auswählbare Minimal- und Maximalwerte.
`format`	Ausgabeformat. ISO, Java/Unicode und gängige Moment-Formate werden unterstützt.
`title`	Dialogtitel.
`locale`	Locale der nativen Picker, sofern unterstützt.
`timezone`	Zeitzone für Parsing und Formatierung.
`is24h`	24-Stunden-Format bevorzugen.
`minuteStep`	Minutenintervall des Time Pickers.
`doneText` / `cancelText`	Eigene Labels für Aktionen.

Beispiel-App

Das Repository enthält eine Capacitor Beispiel-App, die den nativen Date Picker, Time Picker, Range Picker, hide()und Plugin-Versionsaufrufe öffnet.

iOS	Android

API Referenz

Die vollständige API Reference findest du in der README des Packages und in den TypeScript-Definitionen: