Tulaoda Design

rc-cron-editor

cron 表达式生成工具

CRON 表达式简介

CRON 表达式是一个字符串，包含五个到七个由空格分隔的字段，表示一组时间，通常作为执行某个程序的时间表。

例子：每月的最后 1 天：0 0 L * * *

说明：

*    *    *    *    *    *    *
┬    ┬    ┬    ┬    ┬    ┬    ┬
│    │    │    │    │    |    └ year (*)
│    │    │    │    │    └ day of week (0 - 7) (0 or 7 is Sun)
│    │    │    │    └───── month (1 - 12)
│    │    │    └────────── day of month (1 - 31)
│    │    └─────────────── hour (0 - 23)
│    └──────────────────── minute (0 - 59)
└───────────────────────── second (0 - 59, optional)
字段是否必填允许值允许特殊字符备注
Seconds是0–59*,-标准实现不支持此字段。
Minutes是0–59*,-
Hours是0–23*,-
Day of month是1–31*,-?LW?LW 只有部分软件实现了
Month是1–12 or JAN–DEC*,-
Day of week是0–6 or SUN–SAT*,-?L#?L#只有部分软件实现了
Year否1970–2099*,-标准实现不支持此字段。

cron 组成与 type 类型标识与 state 划分

Installation

yarn add @tulaoda/rc-cron-editor

Usage

import CronEditor from '@tulaoda/rc-cron-editor';
const handleCronChange = (cronExpression) => {
  console.log(cronExpression); //0 0 0 * * ?
};
<CronEditor onChange={handleCronChange} tabType="card" showTime value={'0 0 0 * * ?'} />;

API

PropDescriptionDefault
valuecrontab 表达式传值0 0 0 * * ?
onChange值改变触发noop
showRunTime（待优化）本地计算并展示最近五次的运行时间（未全面测试 api，谨慎使用，通常由后端计算返回，也更合理，可作为备选方案。）false
tabTypeantd tab 页签的基本样式，可选 line、card editable-card 类型'line'
showCrontab是否显示 crontab 表达式 input，目前通过 input 修改禁用true

Keywords

cron、react、js

更新日志

1.0.4 (2020-04-03)

  • 修复星期表达式从星期一为 1 的问题

1.0.3 (2019-11-28)

  • 新增 API:tabType、showCrontab

1.0.2 (2019-11-21)

业务需求修改

日：

  • 不指定：‘日’不指定和‘周’不指定，有且仅有一个不指定
  • 第一个值小于等于第二个值
  • 周期：几日开始，每几天执行一次
  • 本月最后一天，不能填，只能是最后一天
  • 具体天数，默认第一天

月：

  • 不指定：删掉
  • 周期：第一个值小于等于第二个值
  • 具体月数，默认第一月

星期：

  • 不指定：‘日’不指定和‘周’不指定，有且仅有一个不指定

  • 周期：第一个值小于等于第二个值

  • 具体星期数：默认星期一

  • 暂时禁用 Input 修改 cron

1.0.1 (2019-11-07)

  • 暂时禁用 Input 修改 cron

1.0.0 (2019-11-07)

  • 增加 propTypes 校验
  • 可选显示客户端计算周期执行时间
  • 修改默认值

License

MIT

3/14/2021, 09:30:52