Configuración Inicial

GitHub

Copiar una solicitud de configuración con los pasos de instalación y la guía de 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.

Instalar

Puede utilizar nuestra configuración asistida por IA para instalar el complemento. Agregue las Capgo habilidades a su herramienta de IA 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';

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

Elige Una Fecha

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

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

Opción	Descripción
`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 estándar.
`title`	Título del diálogo.
`locale`	Idioma utilizado por los seleccionadores nativos donde sea posible.
`timezone`	Zona horaria utilizada para la interpretación y el formato.
`is24h`	Preferir formato de 24 horas.
`minuteStep`	Intervalo de minutos del selector de hora.
`doneText` / `cancelText`	Etiquetas de acción personalizadas.

Example App

La biblioteca incluye un ejemplo de aplicación Capacitor que abre el selector de fecha nativo, selector de hora, selector de rango. hide()Ejemplo de aplicación

iOS	Android

Referencia de @API

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