Nest 的 3 种定时任务

引入 ScheduleModule

新建项目:

bash 复制代码
nest new schedule-task -p npm

安装定时任务的包:

bash 复制代码
npm install @nestjs/schedule

在 AppModule 里引入:

使用 cron 表达式

创建 service:

bash 复制代码
nest g service task --flat --no-spec

通过 @Cron 声明任务执行时间:

CronExpression.EVERY_5_SECONDS 的值:

运行:

bash 复制代码
npm run start:dev

每 5s 会执行一次 handleCron 函数。

cron 表达式有这 7 个字段:

其中年是可选的,所以一般都是 6 个。

此外,Cron 表达式还支持一些特殊字符:

  • :代表所有可能的值。例如,在小时字段中, 表示"每个小时"。
  • ?:用于日期和星期字段。它表示不指定值。通常,日期和星期字段不会同时被指定值,因为它们是互斥的。所以,你可以使用 ? 来表示其中一个字段不指定值。
  • -:用于指定范围。例如,10-12 在小时字段中表示 10 点、11 点和 12 点。
  • ,:用于指定多个值。例如,在小时字段中,10,12,14 表示 10 点、12 点和 14 点。
  • /:用于指定步长。例如,0/15 在分钟字段中表示每 15 分钟。

所以 Nest 提供了一些 cron 表达式常量:

这个 @Cron 装饰器还有第二个参数,可以指定定时任务的名字,还有时区:

时区可以在这里查。

常用的 cron 表达式

  1. 每分钟执行一次
markdown 复制代码
* * * * *

这个表达式会在每分钟的每一秒执行任务。

  1. 每小时执行一次

    0 * * * *

这个表达式会在每小时的第 0 分钟执行任务。

  1. 每天执行一次

    0 0 * * *

这个表达式会在每天的午夜 00:00 执行任务。

  1. 每天特定时间执行

    0 8 * * *

这个表达式会在每天的上午 8:00 执行任务。

  1. 每周一次

    0 0 * * 1

这个表达式会在每周一的午夜 00:00 执行任务。

  1. 每月一次

    0 0 1 * *

这个表达式会在每月的第一天午夜 00:00 执行任务。

  1. 每年一次

    0 0 1 1 *

这个表达式会在每年的 1 月 1 日午夜 00:00 执行任务。

  1. 每小时的第 15 分钟执行

    0 15 * * * *

这个表达式会在每小时的第 15 分钟执行任务。

  1. 每天的上午 9 点到下午 5 点,每小时执行一次

    0 0 9-17 * * *

这个表达式会在每天的上午 9 点到下午 5 点之间,每小时的开始执行任务。

  1. 每周一至周五,每天上午 8 点执行

    0 0 8 * * 1-5

这个表达式会在每周的工作日(周一至周五)的上午 8:00 执行任务。

  1. 每月最后一天的午夜执行

    0 0 0 L * *

这个表达式会在每月的最后一天午夜 00:00 执行任务。请注意,L 是 Quartz Scheduler 的特殊字符,不是所有的 cron 实现都支持它。

  1. 每月第一个星期一的上午 8 点执行
bash 复制代码
0 0 8 ? * 2#1

这个表达式会在每月的第一个星期一的上午 8:00 执行任务。同样地,? 和 # 是 Quartz Scheduler 的特殊字符。

注意:如果你使用的是标准的 Unix/Linux cron,请确保不要使用 Quartz Scheduler 的特殊字符。

@Interval 和 @Timeout

除了 @Cron 之外,可以用 @Interval 指定任务的执行间隔,参数是毫秒值:

用 @Timeout 指定多长时间后执行一次:

综上,我们可以通过 @Cron、@Interval、@Timeout 创建 3 种定时任务。

管理定时任务

我们可以对定时任务增删改查,注入 SchedulerRegistry:

然后在 onApplicationBootstrap 的声明周期里拿到所有的 cronJobs 打印下:



能拿到单个或者全部的定时任务。

后面我们要自己创建定时任务,需要 npm install cron 后。

SchedulerRegistry 提供了 api 让我们删除和添加这三种类型的定时任务。

相关推荐
C++ 老炮儿的技术栈9 分钟前
有符号变量与无符号变量的区别
服务器·开发语言·前端·数据结构·c++·算法·c
aixingpan19 分钟前
aixingpan.cn API开发文档:api_docs_bichart_natalvssecondary2接口指南
前端·php
liangshanbo121532 分钟前
Webpack Tree Shaking 面试题整理
前端·webpack·node.js
wang_shu_mo_ran42 分钟前
Spring IoC和DI概念篇
java·后端·spring
Cheney Pan1 小时前
第4篇 Spring Boot 应用监控:Micrometer 与 JVM 指标
jvm·spring boot·后端·prometheus
去伪存真1 小时前
从乱码到高精度检索:探矿业务中 TXT、Word、PDF 与网页的 RAG 清洗之道
前端·agent
阿钱真强道1 小时前
30 嵌入式操作系统 | 上位机界面:Flask 网页显示 + 控制闭环
后端·python·flask
两个西柚呀1 小时前
JS事件总结
前端·javascript·css
小狼154541 小时前
拼多多订单数据导出 CSV 实战:接口分页、字段平铺与 5 个数据坑,多多开票助手
java·前端·javascript
ss2731 小时前
AI全栈实战 | 2.2-02 React 思维模型:数据不可变 vs Vue 数据可变,两种哲学把复杂度推给谁
前端·vue.js·react.js