Démarrage

Copiez une commande de configuration avec les étapes d'installation et le guide markdown complet pour ce 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.

Installation

Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil IA à l'aide de la commande suivante :

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

Ensuite, utilisez la prompt suivante :

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

Si vous préférez la configuration manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques au plateforme ci-dessous :

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

Importer

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

Choisissez une date

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

Sélectionnez une heure

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

console.log(result.value);

Sélectionnez une date et une heure

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',
});

Sélectionnez un mois

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

Sélectionnez une plage

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

Cacher le sélecteur

await DatePicker.hide();

Options de plateforme

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

Options communes

Option	Description
`mode`	`date`, `time`, `dateAndTime`, `yearAndMonth`, `countDownTimer`ou `range`.
`date`	Valeur sélectionnée par défaut.
`min` / `max`	Valeurs minimale et maximale sélectionnables.
`format`	Format de sortie. Les formats ISO, Java/Unicode et courants Moment sont pris en charge.
`title`	Titre du dialogue.
`locale`	Région utilisée par les sélecteurs natifs où pris en charge.
`timezone`	Heure zone utilisée pour la lecture et la mise en forme.
`is24h`	Préférer l'heure 24.
`minuteStep`	Intervalle de minute du sélecteur d'heure.
`doneText` / `cancelText`	Étiquettes d'action personnalisées.

Application d'exemple

Le dépôt inclut un exemple d'application Capacitor qui ouvre le sélecteur de date natif, le sélecteur d'heure, le sélecteur de plage, et les appels de version du plugin. hide()iOS

Android	Démonstration animée iOS de @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-date-picker s'ouvrant, sélectionnant une date et se fermant

Section intitulée “API Reference”

The complete API reference is maintained in the package README and TypeScript definitions: