Iniciación

Copie una solicitud de comando con los pasos de instalación y la guía markdown completa para este complemento.

        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.

Instale

Puede utilizar nuestra configuración asistida por inteligencia artificial para instalar el complemento. Agregue las Capgo habilidades a su herramienta de inteligencia artificial utilizando el siguiente comando:

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

Luego utilice la siguiente solicitud:

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

Si prefiere la configuración manual, instale el complemento ejecutando los siguientes comandos y siguiendo las instrucciones específicas de la plataforma a continuación:

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

Importar

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

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

Elige una hora

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

console.log(result.value);

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

Elige un mes

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

Elige 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 de fechas

await DatePicker.hide();

Opciones de plataforma

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

Opciones comunes

Descripción	Sección titulada “Opciones comunes”
`mode`	`date`, `time`, `dateAndTime`, `yearAndMonth`, `countDownTimer`, o `range`.
`date`	Valor seleccionado inicial.
`min` / `max`	Valores mínimo y máximo seleccionables.
`format`	Formato de salida. Se admiten formatos ISO, Java/Unicode y Moment 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 hora en 24.
`minuteStep`	Intervalo de minutos del selector de hora.
`doneText` / `cancelText`	Etiquetas de acción personalizadas.

Ejemplo de Aplicación

El repositorio incluye una aplicación de ejemplo Capacitor que abre el selector de fecha nativa, selector de hora, selector de rango, hide()y llamadas de versión del plugin.

iOS	Android

Referencia de API

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