跳过主要内容

日期选择器 Capacitor插件

原生日期、时间、日期时间、年月和范围选择器

iOS、Android和Web

bun add @capgo/capacitor-date-picker bunx cap sync
npm, pnpm 或 yarn
  • npm install @capgo/capacitor-date-picker
  • pnpm add @capgo/capacitor-date-picker
  • yarn add @capgo/capacitor-date-picker

指南

如何在Capacitor中使用日期选择器

在设备上测试

下载Capgo应用程序,然后扫描QRcode

日期选择器插件预览二维码 code

使用 @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 mode.
  • Android 嵌套选项、对话框布局处理和 UI 线程对话处理。
  • 分钟步长和日期范围选择。 is24h全参考
  • __CAPGO_KEEP_0__

__CAPGO_KEEP_0__

常见问题

日期选择器插件FAQ

如何在Capacitor应用中安装日期选择器插件?

运行"bun add @capgo/capacitor-date-picker" (或 "npm install @capgo/capacitor-date-picker"),然后运行 "bunx cap sync" 以便 iOS 和 Android 项目捕获 native code。从 "@capgo/capacitor-date-picker" 导入您的应用code。

是否@capgo/capacitor-date-picker与 React、Vue 和 Angular 一起工作?

是。日期选择器是一个Capacitor包,因此它与任何在Capacitor内运行的 web 框架一起工作,包括 Ionic、React、Vue、Angular、Svelte 和普通 JavaScript。

哪个Capacitor版本支持@capgo/capacitor-date-picker?

Capgo 插件遵循Capacitor的主要版本:使用与Capacitor主要版本匹配的插件主要版本(例如插件 v8 与Capacitor 8)。在GitHub README 中的兼容性表格列出了维护的版本。

是否@capgo/capacitor-date-picker免费和开源?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-date-picker/ and the package is free to install from npm. Bug reports and pull requests are welcome.

是否可以在App Store评估code更新使用Date Picker?

安装或升级插件会改变原生code,因此需要新建一个商店构建。之后,JavaScript、HTML和CSS调用插件的更改可以立即通过Capgo实时更新发布。

不等待应用程序审查即可将日期选择器推送到商店

一旦插件在您的商店构建中,Capgo 即刻将您的 JavaScript、HTML 和 CSS 更改推送给用户。

从 Capgo 开始