Cron Expressioncron 表单

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

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

何时使用#

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

引入模块#

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

代码演示

2024-12-20 03:45:00


2024-12-20 03:45:00
基本

最简单的用法。

expand codeexpand code
      加载中
2024-12-20 03:45:00
2024-12-20 03:45:00
2024-12-20 03:45:00
三种大小

我们为 nz-cron-expression 输入框定义了三种尺寸（大、默认、小），高度分别为 40px、32px 和 24px。

expand codeexpand code
      加载中
2024-12-20 03:45:00
无边框

没有边框

expand codeexpand code
      加载中
2024-12-20 03:45:00
2024-12-20 03:45:00
两种规则类型

我们为 nz-cron-expression 输入框定义了两种规则类型（五段式， 六段式），分别为: nzType="linux"、nzType="spring"。

expand codeexpand code
      加载中
隐藏折叠面板

[nzCollapseDisable]="true"

expand codeexpand code
      加载中
2024-12-21 01:01:00

cron: 1 1 * * *

额外节点

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

expand codeexpand code
      加载中
Next Time: 2024-12-20 04:10:00
自定义渲染 cron 时间

自定义渲染下次执行时间

expand codeexpand code
      加载中
2024-12-21 01:00:00
2024-12-21 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)