describeCron()

function describeCron(expression): string;

Defined in: packages/utils/src/cron/describeCron.ts:329

将 cron 表达式翻译为中文自然语言描述

支持标准 5 段格式（分 时 日 月 周）和 6 段格式（秒 分 时 日 月 周）。 字段语法与取值范围见 parseCron。

Parameters

Parameter	Type	Description
expression	string	cron 表达式字符串

Returns

string

中文描述

Throws

Error 表达式非法；非法输入不再降级成伪描述，调用方若用于 UI 展示需自行捕获（UTL-024）

Example

describeCron('* * * * *');       // '每天 每分钟 执行'
describeCron('0 9 * * 1-5');     // '每个工作日 09:00 执行'
describeCron('0 0 1 1 *');       // '1月1 号 00:00 执行'
describeCron('30 18 * * 5');     // '每周五 18:30 执行'