调度quartz/spring cron表达式 获取之后N次运行时间, 之前N次运行时间

概述：

Quartz是一个开源的、轻量级的调度框架，它允许在指定时间或以某个频率执行作业。在使用Quartz时，需要引入Quartz依赖，这样就可以在项目中使用Quartz提供的调度功能。

本文将着重介绍Quartz中获取运行时间的功能。但是目前没有已有的开箱即用的api，分别用于获取指定cron表达式在当前时间之后和之前的若干次运行时间，所以我实现了一下两个函数：computeFireTimesAfter()和computeFireTimesPre()

具体实现时，我们可以通过传入cron表达式和需要获取的次数来调用这两个方法。computeFireTimesAfter()方法会获取指定cron表达式在当前时间之后的若干次运行时间，而computeFireTimesPre()方法会获取指定cron表达式在当前时间之前的若干次运行时间。

在实现这两个方法时，我们需要先实例化一个CronTriggerImpl对象，并设置其cron表达式。然后，通过调用getFireTimeAfter()方法来获取下一次运行时间。为了获取多次运行时间，我们需要在一个循环中不断调用getFireTimeAfter()方法，并将当前时间更新为下一次运行时间。为了方便使用，我们还提供了一个日期格式化方法，将Date类型的时间转换成字符串格式的时间。

1. 引入quartz依赖
   
   org.quartz-scheduler
   quartz
   2.3.0
   
2. 获取运行时间
   a. 之后几次运行时间：

传入参数：cron表达式， 运行次数
public static List computeFireTimesAfter(String cron, int count) throws ParseException {
List runTime = Lists.newArrayList();
// 实例化trigger
CronTriggerImpl cronTrigger = new CronTriggerImpl();
cronTrigger.setCronExpression(new CronExpression(cron));

    // 获取当前时间
    Date currentTime = new Date();

    while (count-- > 0) {
        // 获取下次运行时间
        Date   nextFireTime      = cronTrigger.getFireTimeAfter(currentTime);
        String formattedDateTime = formatTime(nextFireTime);
        runTime.add(formattedDateTime);
        // 更新当前时间为下次运行时间
        currentTime = nextFireTime;
    }

    return Collections.unmodifiableList(runTime);
}

b. 之前几次运行时间：

传入参数：cron表达式， 运行次数
public static Set computeFireTimesPre(String cron, int count) throws ParseException {
Calendar calendar = Calendar.getInstance();
Date now = calendar.getTime();
CronTriggerImpl cronTrigger = new CronTriggerImpl();
cronTrigger.setCronExpression(cron);
Set set = new LinkedHashSet<>();
while (set.size() < count) {
// 获取前一个月时间
calendar.add(Calendar.MONTH, -1);
List dates = TriggerUtils.computeFireTimesBetween(
cronTrigger, null, calendar.getTime(), now).stream().map(each -> formatTime(each)).collect(Collectors.toList());
Collections.reverse(dates);
// 满足期待获取次数则退出循环，否则再向前推一个月获取运行时间
if (dates.size() < count) {
set.addAll(dates);
} else {
set.addAll(dates.subList(0, count));
}
}
return set;
}

private static String formatTime(Date nextFireTime) {
    LocalDateTime localDateTime     = LocalDateTime.ofInstant(nextFireTime.toInstant(), ZoneId.systemDefault());
    String        formattedDateTime = localDateTime.format(COMMON_TIME_PATTERN);
    return formattedDateTime;
}

二、计算cron将要执行的任务次数
要得到 Quartz 中设置的 Cron 表达式的任务将会执行的次数，您可以使用 CronTrigger 类中的 getNextValidTimeAfter() 和 getFireTimeAfter() 方法来计算触发时间。以下是一个示例代码片段，它演示了如何使用 CronTrigger 类计算将要执行的任务次数：

import org.quartz.CronExpression;
import org.quartz.CronTrigger;
import org.quartz.impl.triggers

.CronTriggerImpl;
import java.text.ParseException;
import java.util.Date;

public class QuartzCronExpressionExample {

public static void main(String[] args) throws

ParseException {

    // 创建 CronTrigger 对象
    CronTriggerImpl trigger = new CronTriggerImpl();
    trigger.setCronExpression

(“0 0/5 * * * ?”); // 设置 Cron 表达式，每隔 5 分钟执行一次

    // 计算任务将会执行的次数
    CronExpression cronExpression = new CronExpression(trigger.getCronExpression());
    Date nextValidTime = cronExpression.getNextValidTimeAfter(new Date());
    Date endTime = new Date(nextValidTime.getTime() + (5 * 60 * 1000)); // 设置任务的结束时间，5 分钟后

    int count = 0;
    while (nextValidTime.before(endTime)) {
        System.out.println("Task will run at: " + nextValidTime);
        nextValidTime = cronExpression.getFireTimeAfter(nextValidTime);
        count++;
    }

    System.out.println

(“Task will run " + count + " times.”);
}
}