@capgo/capacitor-date-picker

中文文档
8.1.14发布于 2026/10/15MPL-2.0TypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 5.6万

IOS,Android的原生Capacitor取日期器,并有针对长期社区问题的修补.

中文使用文档
文档目录15 节
  1. *免费开始*
  2. 主要特点
  3. 我们的固定
  4. 演示
  5. 截图
  6. 安装
  7. 使用量
  8. 平台说明
  9. API 密码
  10. 当前(...)
  11. 当前区域(...)
  12. 隐藏( c)
  13. 获取 PluginVersion ()
  14. 接口
  15. 类型异名

@ capgo/ 电容- 日期选择器

在 iOS 和 Android 上显示您 Capacitor app 的本地日期和时间选择器, 并附带网络回落 。 取出日期,时间,年份和月份,或一个日期范围,有一个呼叫.

Capgo - Build Capacitor apps with AI, ship updates instantly

队长:在几分钟内将修正推给您的 Capacitor 用户,在没有Mac的情况下构建已签名的iOS和Android apps,并在一击中回滚.

*免费开始*

14天无限自由审判. 不需要信用卡

🤖 建筑与AI编码代理? 安装 Capgo 技能 所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用 @capgo/capacitor-date-picker 在您的电容应用程序中: npx skills add Cap-go/capgo-skills。然后问你的经纪人: 添加@capgo/capor-date-picker到我的Capacitor应用程序上,并把它接通 代理设置指南 • 妇女 主机磁共振

Animated iOS demo showing the native date picker opening, selecting a date, and closing

主要特点

  • 拾取模式数字 : date, (中文(简体) ), time, (中文(简体) ), dateAndTime, (中文(简体) ), countDownTimer, (中文(简体) ), yearAndMonth (iOS和网络)和 range。 。 。 .
  • 范围选择数字 : presentRange() 返回开始和结束日期.
  • 自定义数字 : locale,轻或暗 theme,以及 minuteStep 为时间选择者.
  • 控制权数字 : present() 打开拾取器 hide() 关闭它.
  • 平台: iOS,Android和Web. 互联网档案馆的存檔,存档日期2013-12-02. iOS和Android上的原生采取器,浏览器在网络上回落.

原生日期,时间,日期-时间,年份-月,以及iOS,Android和Web上的Capacitor 8的测距取器.

这是Capgo维持的替代方案 @capacitor-community/date-picker. 主要区别在于维护速度:我们聆听社区报告,快速解决问题,以及船只更新,而不是留下长期存在的GitHub问题.

我们的固定

  • 电容8支持.
  • 使用相同的网络 present() API (英语).
  • 程序化 hide()。 。 。 .
  • 对话框标题支持 .
  • iOS旋转安全布局.
  • iOS 本地化日/月标签的本地化处理 .
  • iOS系统 yearAndMonth 模式.
  • 没有 iOS 强制在无效的日期崩溃 .
  • ISO, Java/ Unicode, 以及常见的 Moment 风格格式, 如 : YYYY-MM-DD。 。 。 .
  • 仅限日期的时区处理没有一天的班次.
  • iOS系统 min 财务报告和审定财务报表 max 用 ISO 字符串解析 .
  • 机器人筑巢 android 选项.
  • 机器人 is24h。 。 。 .
  • Android Date AndTime在移动到时间时保留所选择的日期.
  • Android 对话框宽度/放出处理 .
  • Android UI- Thread 对话框正在处理, 因此本地对话框从 Capacitor 调用中可靠打开 .
  • 计时器的分钟步骤.
  • 通过 presentRange()。 。 。 .

演示

iOS系统机器人
Animated iOS demo showing the native date picker opening, selecting a date, and closingAnimated Android demo showing the native date picker opening, selecting a date, and closing

截图

iOS系统机器人
iOS native date pickerAndroid native date picker

安装

您可以使用我们的 AI 辅助设置安装插件 。 使用以下命令将 Capgo 技能添加到您的 AI 工具 :

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

然后使用下列提示:

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

如果您更喜欢手动设置,请通过运行以下命令来安装插件,并遵循下面的平台特定指令:

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

使用量

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

console.log(result.value);
const time = await DatePicker.present({
  mode: 'time',
  is24h: true,
  minuteStep: 15,
  format: 'HH:mm',
});
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);

平台说明

  • iOS 用途 UIDatePicker 使用自动布局使拾取者在屏幕旋转中存活下来.
  • Android 使用平台 DatePickerDialog 财务报告和审定财务报表 TimePickerDialog; 范围选择是两个本地日期选择.
  • Web在小型模式包装上使用本地浏览器输入.
  • minuteStep 被四舍五入到iOS上平台支持的间隔.

API 密码

当前(...)

present(options?: DatePickerOptions | undefined) => Promise<DatePickerResult>

呈取枣者.

参数类型
optionsDatePickerOptions

回返情况: Promise<DatePickerResult>


当前区域(...)

presentRange(options?: DatePickerRangeOptions | undefined) => Promise<DatePickerRangeResult>

呈现出一个取地者。 土著平台使用两个土著日期选择; 网页在一个对话框中显示始末控件.

参数类型
optionsDatePickerRangeOptions

回返情况: Promise<DatePickerRangeResult>


隐藏( c)

hide() => Promise<void>

关闭当前可见的拾取器, 如果有的话 .


获取 PluginVersion ()

getPluginVersion() => Promise<PluginVersionResult>

返回平台执行版本标记 .

回返情况: Promise<PluginVersionResult>


接口

日期选择结果

Prop类型说明
valuestring | null格式化值 。 Null表示拾取者被开除.

日期选择选项

Prop类型说明
minstring最小可选值 .
maxstring最大可选值 .
datestring初始选中值 .
iosDatePickerIosOptions平台专用iOS选项凌驾于顶级选项.
androidDatePickerAndroidOptions平台专用Android选项凌驾于顶级选项之上.

日期选择

Prop类型说明默认
styleDatePickerIosStyleiOS采取器风格."inline"
titleFontColorstring
titleBgColorstring
bgColorstring
fontColorstringIOS上的 picker文本颜色. 私人用途 textColor 支持时 KVC; 否则返回到 tintColor (只有accent,不能保证轮标文本).
buttonBgColorstring
buttonFontColorstring
mergedDateAndTimeboolean尽可能在一个 UIDatePicker 中显示日期和时间 .

日期选择Android 选项

Prop类型说明
themeDatePickerThemeAndroid 对话框主题资源名或内置主题密钥.

日期选择区域结果

Prop类型说明
startstring | null格式化起始值 。 Null表示拾取者被开除.
endstring | null格式化端值 。 Null表示拾取者被开除.
valuestring | null选择两个日期时的“ 起始/ 结束” 值 .

日期选择选项

Prop类型说明
startstring初始范围起始值 .
endstring初始范围结束值 .
startTitlestring选择起始日期时使用的标题 .
endTitlestring选择结束日期时使用的标题 .

插件变压器

Prop类型
versionstring

类型异名

日期缩写

'wheels' | 'inline' | 'compact' | 'automatic'

日期选择器主题

'light' | 'dark' | string

版本与发布记录

@capgo/capacitor-date-picker 共发布 11 个版本,首次发布于 2026/05/28;过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
8.1.14latest2026/10/1525 天前
8.1.132026/10/1327 天前
8.1.122026/10/1030 天前
8.1.112026/10/1030 天前
8.1.102026/10/091 个月前
8.1.82026/10/081 个月前

关于 @capgo/capacitor-date-picker 的常见问题

@capgo/capacitor-date-picker 是什么?

IOS,Android的原生Capacitor取日期器,并有针对长期社区问题的修补.

如何安装 @capgo/capacitor-date-picker?

在项目目录运行 npm install @capgo/capacitor-date-picker,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@capacitor/core(>=8.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@capgo/capacitor-date-picker 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@capgo/capacitor-date-picker 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@capgo/capacitor-date-picker 可以商用吗?

@capgo/capacitor-date-picker 使用 MPL-2.0 许可。弱 Copyleft:可以商用,也可以和闭源代码一起使用;但如果分发时修改了 MPL 授权的文件,这些文件的修改需以 MPL 开源。以上为概括,不构成法律意见,请以许可原文为准。

@capgo/capacitor-date-picker 的下载量有多少?

根据 npm 官方下载统计,@capgo/capacitor-date-picker 在 2026/10/09 – 2026/11/07 这 30 天内被下载 56,418 次,日均约 1,881 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@capgo/capacitor-date-picker 还在维护吗?

最新版本 8.1.14 发布于 2026/10/15(25 天前);至今共发布 11 个版本,其中过去 12 个月发布了 11 个;首次发布于 2026/05/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。