Getting Started

Copia una riga di configurazione con i passaggi di installazione e la guida markdown completa per questo 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.

Installa

Puoi utilizzare la nostra configurazione assistita dall'IA per installare il plugin. Aggiungi le Capgo competenze al tuo strumento di AI utilizzando il seguente comando:

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

Poi utilizza il seguente prompt:

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

Se preferisci l'installazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:

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

Importa

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

Scegli una data

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

Scegli un'ora

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

console.log(result.value);

Scegli data e ora

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

Scegli un mese

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

Scegli un intervallo

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

Nascondi il picker

await DatePicker.hide();

Opzioni per piattaforma

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

Opzioni comuni

Opzione	Descrizione
`mode`	`date`, `time`, `dateAndTime`, `yearAndMonth`, `countDownTimer`, o `range`.
`date`	Valore selezionato iniziale.
`min` / `max`	Valori minimi e massimi selezionabili.
`format`	Formato di output. Sono supportati formati ISO, Java/Unicode e Moment-style comuni.
`title`	Titolo del dialogo.
`locale`	Lingua utilizzata dai picker nativi dove supportata.
`timezone`	Fuso orario utilizzato per la parsing e la formattazione.
`is24h`	Preferisci l'orario 24 ore.
`minuteStep`	Intervallo di minuti del picker orario.
`doneText` / `cancelText`	Etichette di azione personalizzate.

Esempio di App

Il repository include un Capacitor esempio di app che apre il picker di data nativo, picker di ora, picker di intervallo. hide()e versione del plugin.

iOS	Android

Riferimento a @API

La documentazione completa di @API è mantenuta nel file README e nelle definizioni TypeScript: