@danielmoncada/angular-datetime-picker

中文文档
22.0.0发布于 2026/08/05MITTypeScriptES Module近 30 天下载 22.6万

角约会时间拾取器

中文使用文档
文档目录16 节
  1. 中断更改
  2. 说明
  3. 如何使用
  4. 选择日期执行
  5. 属性 owl-date-time
  6. 活动 owl-date-time
  7. 属性 input[owlDateTime]
  8. 活动 input[owlDateTime]
  9. 属性 [owlDateTimeTrigger]
  10. 属性 [owlDateTimeTrigger]
  11. 属性 owl-date-time-inline
  12. 本地化和日期时间格式
  13. 依赖关系
  14. 演示
  15. 许可证
  16. 作者

: 日期: : 小时1: 角日期/时间拾取器

npm npm

此软件包的当前版本支持 Angular 22

如果您需要其它角版本的支持, 请参见 中断更改 见下文.

中断更改

  • 22.x.x版本为Angular 22的正式发布,也支持Angular 21.
  • 21.x.x版本是Angular 21的正式发布,它也支持Angular 20.
  • 20.x.x版本是Angular 20的正式发布,它也支持Angular 19.
  • 版本19.x.x >=已不支持ng 18. 如果您需要ng 18支持,请坚持18.x.x版本.
  • 版本18.x.x 已不支持ng 17. 如果您需要ng 17支持,请坚持17.x.x版本.
  • 版本17.x.x->=已不支持ng 16-13. 如果需要ng 16-13支持,请坚持16.x.x版本.
  • 14.x.x >=已不支持 < ng 13. 如果您需要 View 引擎支持,请坚持13.x.x版本.
  • 13.1.0+版本不再支持 MomentJs 时间适配器。 如果您想要使用 MomentJs 适配器, 请查看 GitHub 图像 或者说 无。 。 。 .
  • 需要ng 8支持时,请坚持: https://github.com/DanielYKPan/date-time-cicker 互联网档案馆的存檔,存档日期2013-12-21

说明

简单的角枣取时器. 在线医生 这里,在线演示(StackBlitz)是 这里 财务报告和审定财务报表 这里。 。 。 . 这个拾取器是反应性的设计,所以可以随意在您的桌面,平板电脑和移动设备中尝试.

如何使用

  1. 安装方式 无数字 : npm install @danielmoncada/angular-datetime-picker --save

  2. 安装 @angular/cdk,它是一个对等依赖,并提供采取者使用的覆盖: npm install @angular/cdk --save。 。 。 . 如果您的应用程序已经使用 角质材料,为您安装了 CDK,这个步骤(和下面的上覆样式)已经覆盖了.

  3. 添加样式. 拾取器将它的弹出/对话框放入一个CDK上方,所以你既需要拾取器样式,也需要CDK预建的上方样式. 如果你是的话 没有 使用角材料, 加入一次 styles.scss数字 :

    @use '@angular/cdk/overlay-prebuilt.css';
    @use '@danielmoncada/angular-datetime-picker/assets/style/picker.min.css';
    

    或通过 styles 阵列 angular.json数字 :

    "styles": [
        "node_modules/@angular/cdk/overlay-prebuilt.css",
        "node_modules/@danielmoncada/angular-datetime-picker/assets/style/picker.min.css",
        "src/styles.scss"
    ]
    

    (如果您已经导入 Angular 材料的主题, 则包含 CDK 覆盖样式, 您只需要取取取样式 。)

  4. 添加 猫头鹰时间模块 财务报告和审定财务报表 猫头鹰时间模块 给您的 @ NgMudule (英语) 类似下文的例子

    import { NgModule } from '@angular/core';
    import { BrowserModule } from '@angular/platform-browser';
    import { MyTestApp } from './my-test-app';
    import { OwlDateTimeModule, OwlNativeDateTimeModule } from '@danielmoncada/angular-datetime-picker';
    
    @NgModule({
        imports: [BrowserModule, OwlDateTimeModule, OwlNativeDateTimeModule],
        declarations: [MyTestApp],
        bootstrap: [MyTestApp],
    })
    export class MyTestAppModule {}
    
  5. 连接拾取器与输入和触发器.

    <input [owlDateTime]="dt1" [owlDateTimeTrigger]="dt1" placeholder="Date Time" /> <owl-date-time #dt1></owl-date-time>
    
    <input [owlDateTime]="dt2" placeholder="Date Time" />
    <span [owlDateTimeTrigger]="dt2"><i class="fa fa-calendar"></i></span>
    <owl-date-time #dt2></owl-date-time>
    

    以上例子相当基本。 拾取者还有更多特征, 你可以更多地了解这些 演示页面。 。 。 .

选择日期执行

日期取出器的建造是日期执行不可知. 开发者需要确保为拾取者提供合适的棋子来配合所选择的实施. 有两个预先制作的模块,用户需要导入其中的一款或自己建一款(从 这里) (中文(简体) ).

  • OwlNativeDateTimeModule - 支持本地 JavaScript 日期对象
  • OwlUnixTimestampDateTimeModule - 支持自Epoch起的毫秒(数目)
日期/时间适应器扩展

https://day.js.org/ (中文(简体) )

  • OwlDayJsDateTimeModule - 对DayJs的支持
    • 您必须安装一个可选的插图来使用 。 见 这里, (中文(简体) ), 无

https://momentjs.com/ 请检查isbn=值 (帮助)

  • OwlMomentDateTimeModule - 支持运动Js
    • 您必须安装一个可选的插图来使用 。 见 这里, (中文(简体) ), 无

属性 owl-date-time

名称类型需求默认说明
pickerTypeboth, (中文(简体) ), calendar, (中文(简体) ), timer可选both设定日期时间拾取器的类型 . both: 显示日历和计时器, calendar: 只显示日历, timer:只有显示计时器.
pickerModepopup, (中文(简体) ), dialog可选popup选手的风格会打开.
startViewmonth, (中文(简体) ), year, (中文(简体) ), multi-year可选month关于日历应该开始的观点.
yearOnly布尔可选false限定日历仅显示月份选择的年份和多年期视图.
showCalendarWeeks布尔可选false是否在日历中显示日历周 .
multiyearOnly布尔可选false限制日历只显示选择年份的多年视图.
startAt吨/吨可选null打开拾取器开始的时刻.
endAt吨/吨可选null区域日历结束时间的默认选择时间
firstDayOfWeek编号可选0设出礼拜一日. 有效值从0到6. 0:星期日至6:星期六
showSecondsTimer布尔可选false当指定为真时, 它会显示一个定时器来配置第二个值
hideOtherMonths布尔可选false是否在本月份开始或结束时隐藏其他月份的日期
hour12Timer布尔可选false当指定为真时, 计时器将以小时12 格式模式
stepHour编号可选1每一步换个小时.
stepMinute编号可选1每一步变化一分钟.
stepSecond编号可选1每步变化秒.
scrollStrategy滚动战略可选BlockScrollStrategy打开拾取器时定义滚动策略 。 学这些 https://material.angular.io/cdk/overlay/overview#scroll-战略。 。 。 .
disabled布尔可选false当指定为真时, 它会禁用拾取器 .
backdropClass字符串/字符串 []可选null采取背景的自定义类 .
panelClass字符串/字符串 []可选null采取器上覆面板的自定义类 .

活动 owl-date-time

活动参数说明
beforePickerOpen无效在拾取器打开前召回引用
afterPickerOpen无效打开拾取器时召回引用
afterPickerClosed无效采取者闭口后召回引出.
yearSelectedT级选择年份时召回引用 。 这并不意味着选定日期有所改变.
monthSelectedT级选定月份时调用以引用 。 这并不意味着选定日期有所改变.
dateClickedT级当选定数据发生变化时调用 .
selectedChangedT级当当前选中的数据改变时调用 .
userSelection无效选择任何日期时召回 .

属性 input[owlDateTime]

名称类型需求默认说明
owlDateTimeOwlDateTimeComponent<T>需求null此输入相关的日期时间选择器 .
owlDateTimeFilter( date: T)=>boolean 可选null过滤日期时间的函数 .
disabled布尔可选false当指定为真时, 它会禁用拾取器的输入 .
min<T>可选null最小有效日期时间 .
max<T>可选null最长有效日期时间 .
selectModesingle, (中文(简体) ), range, (中文(简体) ), rangeFrom, (中文(简体) ), rangeTo可选single指定拾取器的选择模式. single: 允许的单一值, range:允许用户选择日期时间范围, rangeFrom:输入只显示出"从"值,取出者只能选择出"从"值, rangeTo:输入只显示"to"值,取出者只能选择"to"值.
rangeSeparator字符串可选-将输入值中的“ 从” 和“ 到” 区分开来字符 .

活动 input[owlDateTime]

活动参数说明
dateTimeChange资料来源:猫头鹰时间输入,值:输入值,输入:输入元素召回时引用 change 事件为此开火 <input [owlDateTime]>
dateTimeInput资料来源:猫头鹰时间输入,值:输入值,输入:输入元素当一个 input 事件为此开火 <input [owlDateTime]>。 。 。 .

属性 [owlDateTimeTrigger]

名称类型需求默认说明
owlDateTimeTriggerOwlDateTimeComponent<T>需求null此触发器相关的日期时间选择器 .
disabled布尔可选false当指定为真时, 它会禁用触发器 .

属性 [owlDateTimeTrigger]

名称类型需求默认说明
owlDateTimeTriggerOwlDateTimeComponent<T>需求null此触发器相关的日期时间选择器 .
disabled布尔可选false当指定为真时, 它会禁用触发器 .

属性 owl-date-time-inline

名称类型需求默认说明
pickerTypeboth, (中文(简体) ), calendar, (中文(简体) ), timer可选both设定日期时间拾取器的类型 . both: 显示日历和计时器, calendar: 只显示日历, timer:只有显示计时器.
startViewmonth, (中文(简体) ), year, (中文(简体) ), multi-year可选month关于日历应该开始的观点.
startAt吨/吨可选null打开拾取器开始的时刻.
endAt吨/吨可选null区域日历结束时间的默认选择时间
firstDayOfWeek编号可选0设出礼拜一日. 有效值从0到6. 0:星期日至6:星期六
showSecondsTimer布尔可选false当指定为真时, 它会显示一个定时器来配置第二个值
hideOtherMonths布尔可选false是否在本月份开始或结束时隐藏其他月份的日期
hour12Timer布尔可选false当指定为真时, 计时器将以小时12 格式模式
stepHour编号可选1每一步换个小时.
stepMinute编号可选1每一步变化一分钟.
stepSecond编号可选1每步变化秒.
disabled布尔可选false当指定为真时, 它会禁用拾取器 .
owlDateTimeFilter( date: T)=>boolean 可选null过滤日期时间的函数 .
min<T>可选null最小有效日期时间 .
max<T>可选null最长有效日期时间 .
selectModesingle, (中文(简体) ), range, (中文(简体) ), rangeFrom, (中文(简体) ), rangeTo可选single指定拾取器的选择模式. single: 允许的单一值, range:允许用户选择日期时间范围, rangeFrom:输入只显示出"从"值,取出者只能选择出"从"值, rangeTo:输入只显示"to"值,取出者只能选择"to"值.

本地化和日期时间格式

不同语言和格式的本地化由 OWL_DATE_TIME_LOCALE 财务报告和审定财务报表 OWL_DATE_TIME_FORMATS您可以从 这里。 。 。 .

依赖关系

  • @angular/cdk ——提供取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取 记住要包括 CDK 覆盖样式(@use '@angular/cdk/overlay-prebuilt.css';除非您已经使用角材料。 见 如何使用。 。 。 .

演示

  • 在线医生 这里
  • 在线演示( StackBlitz) 是 这里 财务报告和审定财务报表 这里

许可证

  • 许可证:麻省理工学院

作者

由丹尼尔·蒙卡达(Daniel Moncada)维护和更新, 由丹尼尔·潘(Daniel Pan)原创执行

版本与发布记录

@danielmoncada/angular-datetime-picker 共发布 50 个版本,首次发布于 2020/02/12;过去 12 个月发布了 3 个版本。

版本发布日期距今
22.0.0latest2026/08/053 个月前
21.0.02026/01/289 个月前
20.0.12025/11/2011 个月前
20.0.02025/07/141.3 年前
19.1.22025/05/231.5 年前
19.1.12025/03/311.6 年前

其他发布通道:alhpa → 10.0.0-alpha.0。

关于 @danielmoncada/angular-datetime-picker 的常见问题

@danielmoncada/angular-datetime-picker 是什么?

角约会时间拾取器

如何安装 @danielmoncada/angular-datetime-picker?

在项目目录运行 npm install @danielmoncada/angular-datetime-picker,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@angular/common(^21.0.0 || ^22.0.0)、@angular/core(^21.0.0 || ^22.0.0)、@angular/cdk(^21.0.0 || ^22.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@danielmoncada/angular-datetime-picker 支持 TypeScript 吗?

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

@danielmoncada/angular-datetime-picker 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@danielmoncada/angular-datetime-picker 可以商用吗?

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

@danielmoncada/angular-datetime-picker 的下载量有多少?

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

@danielmoncada/angular-datetime-picker 还在维护吗?

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