跳过主要内容
返回插件
@capgo/capacitor-date-picker
教程
@capgo/capacitor-date-picker

日期选择器

原生日期、时间、日期时间、年月和范围选择器,适用于 iOS、Android 和 Web

指南

__CAPGO_KEEP_0__日期选择器教程

使用@capgo/capacitor-date-picker

@capgo/capacitor-date-picker Capacitor为iOS和Android原生日期、时间、日期时间、年月和范围选择器,提供Web fallback。

这是Capgo维护的替代方案 @capacitor-community/date-picker我们关注社区反馈,快速修复问题,并将更新发布,而不是让GitHub长期未解决的问题。

安装

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

原生选择器演示

iOS Android
动画iOS示例@capgo/capacitor-date-picker打开,选择日期并关闭 动画Android示例@capgo/capacitor-date-picker打开,选择日期并关闭

原生选择器截图

iOS Android
iOS截图@capgo/capacitor-date-picker显示原生日期选择器 Android截图@capgo/capacitor-date-picker显示原生日期选择器

选择日期

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

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

选择时间

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

选择时间段

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

关闭活动选择器

await DatePicker.hide();

解决的问题

  • Capacitor 8 支持。
  • Web 实现与之相同 present() API。
  • 程序化 hide().
  • 对话标题支持
  • iOS 旋转安全布局、地区处理和 yearAndMonth 模式。
  • 更安全的日期解析和日期-仅时区处理。
  • Android 嵌套选项、对话布局处理和 UI 线程对话处理。 is24h分钟步骤和日期范围选择。
  • 全参考文档

__CAPGO_KEEP_0__ 8 support.