Empezar

Copie un comando de configuración con los pasos de instalación y la guía de markdown completa para este 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.

Instalación

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

Importar

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

Elegir Fecha

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

Elegir Hora

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

console.log(result.value);

Elegir Fecha y Hora

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

Elegir Un Mes

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

Elegir Un Rango

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

Ocultar El Selector

await DatePicker.hide();

Opciones De La Plataforma

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

Opciones comunes

Opción	Descripción
`mode`	`date`, `time`, `dateAndTime`, `yearAndMonth`, `countDownTimer`, o `range`.
`date`	Valor seleccionado inicial.
`min` / `max`	Rango mínimo y máximo de selección.
`format`	Formato de salida. Se admiten formatos ISO, Java/Unicode y Moment-style comunes.
`title`	Título del diálogo.
`locale`	Idioma utilizado por los seleccionadores nativos donde se admite.
`timezone`	Zona horaria utilizada para la interpretación y formateo.
`is24h`	Preferir formato de 24 horas.
`minuteStep`	Intervalo de minutos del reloj de selección.
`doneText` / `cancelText`	Etiquetas de acciones personalizadas.

Ejemplo de aplicación

El repositorio incluye un ejemplo de aplicación Capacitor que abre el calendario de fecha nativo, el reloj de selección, el rango de selección, y las llamadas de versión de plugin. hide()iOS

Android	Demo animada de iOS de @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-date-picker abriendo, seleccionando una fecha, y cerrando

API Referencia

La referencia completa de API se mantiene en el archivo README del paquete y definiciones de TypeScript: