@capacitor-community/date-picker

中文文档
7.1.0发布于 2025/09/12MITTypeScriptESM + CJS零依赖近 30 天下载 2.2万

Capacitor Apps 本地日期时间拾取器插件

中文使用文档
文档目录25 节
  1. 约会拾取器
  2. 维护者
  3. 通知
  4. 安装
  5. 升级指南
  6. 路线图
  7. 欧斯
  8. 机器人
  9. 网络
  10. API 密码
  11. IOS 配置( R) DatePickerOptions (中文(简体) )
  12. Android 配置( R) DatePickerOptions (中文(简体) )
  13. 日期格式
  14. iOS系统
  15. 机器人
  16. Android 主题
  17. 演示
  18. 使用量
  19. 控制器配置
  20. iOS 设置
  21. 机器人设置
  22. 更新
  23. 示例
  24. 许可证
  25. 贡献者


约会拾取器

@capacitor-community/date-picker

本地 Date Picker 的电容社区插件


维护者

维护者GitHub 图像社会
斯特万·席尔瓦炖鱼@stewones (英语)
丹尼尔·佩雷拉丹尼尔·普拉泽韦多@ 丹丹普尔

通知

我们从一个正式的Ong开始 如果您使用上一个 npm 软件包 capacitor-datepick请更新您的软件包 @capacitor-community/date-picker检查 更改日志 需要更多信息.

安装

使用 npm :

npm install @capacitor-community/date-picker

使用线条 :

yarn add @capacitor-community/date-picker

同步本地文件 :

npx cap sync

升级指南

从 2.* 改为 3.* 我们有一些新的设置. 你可以看到在 定义 档案,我们有部分 ios 财务报告和审定财务报表 android。您必须修改格式配置为 ios 财务报告和审定财务报表 android 相会相会.

这很重要!

为了保持社区插件的一致性,我们更改了插件所在变量的名称. 当我们在电容器插件输入生态系统时, 我们觉得这是一个很好的机会

在使用插件之前, 您需要像这样导入

import '@capacitor-community/date-picker';
import { Plugins } from '@capacitor/core';
const { DatePickerPlugin } = Plugins;

现在,我们没有 Plugins 变量,我们不注册 DatePickerPlugin 内 Capacitor.Plugins 要使用此插件 .

现在, 要使用这个插件, 您需要这样做

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

你需要替换所有代码

你也得遵守机器人指南.

路线图

欧斯

  • 当前
  • 配置
    • 样式
    • 格式
    • 语言
    • 日期
    • 模式
    • 主题
    • 时区
    • 分钟
    • 最大数
    • 已完成文本
    • 取消文本
    • 24小时
    • 标题
    • 标题Bg 颜色
    • bg 颜色
    • 字体颜色
    • 按钮Bg 颜色
    • 按钮颜色
    • 合并日期和时间

机器人

  • 当前
  • 配置
    • 格式
    • 语言
    • 日期
    • 模式
    • 主题
    • 时区
    • 分钟
    • 最大数
    • 已完成文本
    • 取消文本
    • 24小时

网络

  • 当前
  • 配置
    • 格式
    • 语言
    • 模式
    • 主题
    • 背景情况
    • 分钟
    • 最大数
    • 已完成文本
    • 取消文本
    • 时区
    • 标题

API 密码

  • present(DatePickerOptions): Promise<{ value:string }>

IOS 配置( R)DatePickerOptions(中文(简体) )

这些选项可以通过 present 方法和/或内部 capacitor.config.json

名称类型默认
格式string"yyyy-MM-dd'T'HH:mm:ss.sssZ"
样式string如果iOS 14,则 "inline" 仅限 "wheels"
语言stringcurrent device
日期stringcurrent date
模式DatePickerMode"dateAndTime"
主题DatePickerThemecurrent device
时区stringcurrent device
分钟stringnull
最大数stringnull
已完成文本string"OK"
取消文本string"Cancel"
24小时booleanfalse
标题stringnull
标题Bg 颜色stringnull
bg 颜色stringnull
字体颜色stringnull
按钮Bg 颜色stringnull
按钮颜色stringnull

Android 配置( R)DatePickerOptions(中文(简体) )

这些选项可以通过 present 方法和/或内部 capacitor.config.json

名称类型默认
格式string"yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"
语言stringcurrent device
日期stringcurrent date
模式DatePickerMode"dateAndTime"
主题DatePickerTheme"light"
时区stringcurrent device
分钟stringnull
最大数stringnull
已完成文本string"OK"
取消文本string"Cancel"
24小时booleanfalse

更多信息请检查 definitions 文件

日期格式

对于格式,我们定义了旧的配置 贬值,因为我们有不一致的Android和iOS平台

现在您需要定义您的forma配置 android.format 财务报告和审定财务报表 ios.format

iOS系统

对于iOS格式,您需要遵循此格式 文档

机器人

对于Android格式,您需要遵循此格式 文档

Android 主题

您可以通过资源样式检查定义您的个性化主题 示例应用程序

您如何以实例来看待, 只需在全球资产中定义您的拾取器主题 您的应用程序并发送到 android.theme 在您的电容. config 文件中的道具 options.android.theme 现职.

演示

使用量

import { DatePicker } from '@capacitor-community/date-picker';
import type { DatePickerTheme } from '@capacitor-community/date-picker/src';
const selectedTheme: DatePickerTheme = 'light';

DatePicker.present({
  mode: 'date',
  locale: 'pt_BR',
  date: '13/07/2019',
  theme: selectedTheme,
  ios: {
    format: 'dd/MM/yyyy',
  },
  android: {
    format: 'dd/MM/yyyy',
  },
}).then(date => alert(date.value));

控制器配置

{
  //...
  "plugins": {
    "DatePickerPlugin": {
      "mode": "date",
      "locale": "pt_BR",
      "current": "13/07/2019",
      "format": "dd/MM/yyyy",
      "android": {
        "theme": "MyCustomeTheme"
      },
      "ios": {
        "style": "wheels"
      }
    }
  }
}

iOS 设置

  • ionic start my-cap-app --capacitor
  • cd my-cap-app
  • npm install --save @capacitor-community/date-picker
  • mkdir www && touch www/index.html
  • sudo gem install cocoapods (仅一次)
  • npx cap add ios
  • npx cap sync ios (每次你跑动) npm install(中文(简体) )
  • npx cap open ios

提示:每次您更改本地代码时, 您可能需要清理缓存( Product > Clean building文件夹) , 然后再次运行应用程序 .

机器人设置

  • ionic start my-cap-app --capacitor
  • cd my-cap-app
  • npm install --save @capacitor-community/date-picker
  • mkdir www && touch www/index.html
  • npx cap add android
  • npx cap sync android (每次你跑动) npm install(中文(简体) )
  • npx cap open android

现在你该走了 尝试使用 ionic cap run android --livereload --address=0.0.0.0。 。 。 .

提示:每次您更改本地代码, 您可能需要清理缓存( Build > Clean Project QQ Build > Rebuilt Project) , 然后再次运行应用程序 .

更新

对于已有的项目, 您可以使用此单项命令升级所有与电容器相关的软件包( 包括此插件)

npx npm-upgrade '*capacitor*' && npm install

示例

https://github.com/concessor-community/date-picker/tree/master/example 互联网档案馆的存檔,存档日期2013-12-11

许可证

麻省理工学院

贡献者

感谢这些伟大的人emoji 密钥:

Stew
缝

💻 📖
Daniel Pereira
丹尼尔·佩雷拉

💻 📖 🚧
Caroline Oliva
卡罗琳·奥利瓦

💻
jcesarmobile
jcesarmobile 移动

💻
Valentin
瓦伦汀

💻
Jordi De Pau
乔迪·德波

⚠️

本项目遵循 全部贡献者 规格。 任何捐款都欢迎!

版本与发布记录

@capacitor-community/date-picker 共发布 15 个版本,首次发布于 2020/06/28;过去 12 个月发布了 0 个版本。

版本发布日期距今
7.1.0latest2025/09/121.2 年前
7.0.02025/03/141.7 年前
6.0.02024/05/042 年前
5.0.02023/05/183 年前
4.0.02023/03/173 年前
4.0.0-1next2023/02/253 年前

其他发布通道:beta → 0.3.0,next → 4.0.0-1。

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

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

Capacitor Apps 本地日期时间拾取器插件

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

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

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

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

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

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

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

@capacitor-community/date-picker 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

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

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

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

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