Cron Expressioncron 表单

NG-ZORRO 实验性功能是指已发布但不稳定或者还未准备好用于生产环境的功能。

开发者或用户可以选择在正式发布前使用这些功能,但是每次发布版本时都可能存在 breaking changes

何时使用#

需要在表单中使用 cron 格式验证时使用。

引入模块#

import { NzCronExpressionModule } from 'ng-zorro-antd/cron-expression';

代码演示

2024-11-15 06:46:00


2024-11-15 06:46:00

最简单的用法。

expand codeexpand code
      加载中
    
2024-11-15 06:46:00
2024-11-15 06:46:00
2024-11-15 06:46:00

我们为 nz-cron-expression 输入框定义了三种尺寸(大、默认、小),高度分别为 40px32px24px

expand codeexpand code
      加载中
    
2024-11-15 06:46:00

没有边框

expand codeexpand code
      加载中
    
2024-11-15 06:46:00
2024-11-15 06:46:00

我们为 nz-cron-expression 输入框定义了两种规则类型(五段式, 六段式),分别为: nzType="linux"nzType="spring"

expand codeexpand code
      加载中
    

[nzCollapseDisable]="true"

expand codeexpand code
      加载中
    
2024-11-16 01:01:00

cron: 1 1 * * *

你可以通过 nzExtra 来指定右侧的内容。

expand codeexpand code
      加载中
    
Next Time: 2024-11-15 07:10:00

自定义渲染下次执行时间

expand codeexpand code
      加载中
    
2024-11-16 01:00:00
2024-11-16 01:00:00

<nz-cron-expression formControlName="cron"></nz-cron-expression>

expand codeexpand code
      加载中
    

API#

别忘记先安装 cron-parser:

npm install cron-parser

nz-cron-expression#

参数说明类型默认值
[nzType]cron 规则类型'linux'|'spring'linux
[nzSize]设置输入框大小'large'|'small'|'default'default
[nzDisabled]禁用booleanfalse
[nzBorderless]是否隐藏边框booleanfalse
[nzCollapseDisable]隐藏折叠面板booleanfalse
[nzExtra]自定义渲染右侧的内容TemplateRef<void>-
[nzSemantic]自定义渲染下次执行时间TemplateRef<void>-

注意#

支持格式#

*    *    *    *    *    *
┬    ┬    ┬    ┬    ┬    ┬
│    │    │    │    │    |
│    │    │    │    │    └ day of week (0 - 7, 1L - 7L) (0 or 7 is Sun)
│    │    │    │    └───── month (1 - 12)
│    │    │    └────────── day of month (1 - 31, L)
│    │    └─────────────── hour (0 - 23)
│    └──────────────────── minute (0 - 59)
└───────────────────────── second (0 - 59, optional)