日期选择器__CAPGO_KEEP_0__插件:安装、设置与示例
返回插件
@capgo/capacitor-date-picker
教程
@capgo/capacitor-date-picker

日期选择器

iOS、Android和Web的原生日期、时间、日期时间、年月和范围选择器

指南

日期选择器教程

使用 @capgo/capacitor-date-picker

@capgo/capacitor-date-picker 为 iOS 和 Android 的 Capacitor 应用程序添加原生日期、时间、日期时间、年月和范围选择器,并在 Web 上提供匹配的fallback。

这是 Capgo 的维护版本 @capacitor-community/date-picker我们关注社区报告、快速修复问题并发布更新,而不是让 GitHub 的长期问题留在那里。

安装

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

原生选择器演示

iOS Android
iOS @capgo/capacitor 日期选择器动画演示 Android @capgo/capacitor 日期选择器动画演示

原生日期选择器截图

iOS Android
iOS @capgo/capacitor 日期选择器原生日期选择器截图 Android @capgo/capacitor 日期选择器原生日期选择器截图

选择一个日期

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分钟步长和日期范围选择。
  • 全参考

Full Reference