Prise en main

Installer

Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil IA en utilisant 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 à la plateforme ci-dessous :

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

Importer

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

Sélectionner 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électionner une heure

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

console.log(result.value);

Sélectionner 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 communs

Option	Description
mode	date, time, dateAndTime, yearAndMonth, countDownTimerou 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 Moment-style courants sont pris en charge.
title	Titre de la boîte de dialogue.
locale	Région utilisée par les sélecteurs natifs où pris en charge.
timezone	Fuseau horaire utilisé pour la lecture et la mise en forme.
is24h	Préférez l'heure 24.
minuteStep	Intervalle de minute pour le sélecteur de temps.
doneText / cancelText	Étiquettes d'action personnalisées.

Application d'exemple

Le dépôt inclut une application d'exemple Capacitor qui ouvre le sélecteur de date natif, le sélecteur de temps, le sélecteur de plage, et les appels de version de 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 référence est maintenue dans le fichier README et les définitions TypeScript :

• README
• Définitions de type