C#如何通过任务创建日期和UNIX Cron表达式获取任务上次执行时间

你使用的Cronos库本身没有内置直接获取上一次执行时间的API，但可以通过以下两种方式实现，同时兼容你已有的使用逻辑和CreatedDate边界限制：

方法1：使用GetNextOccurrences取区间内最后一次执行（实现简单） #

直接查询从CreatedDate到当前时间范围内的所有cron执行点，取最后一个即为上次执行时间，代码示例：

using Cronos;
using System.Linq;

// 业务参数
var cronExp = "0 * * * *";
var createdDate = new DateTime(2024, 1, 1); // 任务首次可运行时间
var now = DateTime.Now;

// 解析cron表达式
var schedule = CrontabSchedule.Parse(cronExp);
// 获取[createdDate, now)区间内所有执行时间
var occurrences = schedule.GetNextOccurrences(createdDate, now).ToList();

DateTime? lastRunTime = null;
if (occurrences.Any())
{
    lastRunTime = occurrences.Last();
}
// 如果lastRunTime为null说明从创建到现在还没有过执行记录

注意：如果任务创建时间距离当前时间跨度特别大（比如数年），这种方式性能会略低，建议用下面的扩展方法实现

方法2：自定义扩展方法实现高效的GetPreviousOccurrence #

可以封装一个通用的扩展方法，直接逆向查找最近的上一次执行时间，性能更稳定：

public static class CronosExtensions
{
    public static DateTime? GetPreviousOccurrence(this CrontabSchedule schedule, DateTime beforeTime, DateTime? notEarlierThan = null)
    {
        // 边界校验：如果早于最早允许时间，直接返回null
        if (notEarlierThan.HasValue && beforeTime <= notEarlierThan.Value)
            return null;

        // 从beforeTime往前逐步查找，默认按5位标准cron的分钟粒度步进，6位秒级cron可调整为AddSeconds(-1)
        var current = beforeTime.AddMinutes(-1);
        while (true)
        {
            var next = schedule.GetNextOccurrence(current);
            if (next < beforeTime)
            {
                // 找到符合条件的执行时间，再判断是否早于最早允许时间
                if (notEarlierThan.HasValue && next < notEarlierThan.Value)
                    return null;
                return next;
            }
            // 没找到就往前推1天
            current = current.AddDays(-1);
            // 超出最早时间边界返回null
            if (notEarlierThan.HasValue && current < notEarlierThan.Value)
                return null;
        }
    }
}

// 调用方式
var schedule = CrontabSchedule.Parse("0 * * * *");
var lastRunTime = schedule.GetPreviousOccurrence(DateTime.Now, createdDate);

额外说明 #

• 如果返回值为null，代表从任务创建时间到当前时间为止，该cron任务还没有过符合条件的执行记录
• 计算时建议统一使用UTC时间，或者调用Cronos的API时传入对应时区参数，避免时区差异导致的计算偏差

内容的提问来源于stack exchange，提问作者vdobes