previousRun and currentRun return null all the time

[Earu]

Describe the bug
previousRun and currentRun return null all the time.

To Reproduce

let date = Cron("0 0 11 * *", { timezone: "Europe/London" }).previousRun();
console.log("PREVIOUS", date);

Expected behavior
The actual date of when the previous run would have ran.

System:

• OS: Windows
• Runtime: Node.js
• Version: v18.15.0

[Hexagon]

Hi!

That's actually by design, both previousRun() and currentRun() only return the time of an actual trigger. There is currently not way to list previous matches, but there is an discussion started at #219

[Earu]

I see. Any idea on how id compute the previous run then?

or in the same vein, figure out if a job was run the same day?

[Hexagon]

You should be able to do something like

import Cron from 'https://esm.run/croner@7.0.5';
const job = new Cron("0 0 11 * * *"); // 11:00:00 every day
const today = new Date(new Date().setHours(0,0,0,0)); // (hours, minutes, seconds, milliseconds)
const firstRunToday = job.nextRun(today);
const earlierTriggerToday = firstRunToday && firstRunToday < new Date();
const laterTriggerToday = job.nextRun() && (job.nextRun().setHours(0,0,0,0) == today.getTime());
console.log(earlierTriggerToday, laterTriggerToday);

Edit (making a bit more modular):

import Cron from 'https://esm.run/croner@7.0.5';

// Function to check if the cron job has triggered earlier today
function hasTriggeredEarlierToday(job) {
    const today = new Date(new Date().setHours(0,0,0,0)); // Start of the current day
    const firstRunToday = job.nextRun(today);

    return firstRunToday && firstRunToday < new Date();
}

// Function to check if the cron job will trigger later today
function willTriggerLaterToday(job) {
    const today = new Date(new Date().setHours(0,0,0,0)); // Start of the current day
    const nextRun = job.nextRun();

    return nextRun && (nextRun.setHours(0,0,0,0) == today.getTime());
}

// Example usage
const job = new Cron("0 0 11 * * *"); // 11:00:00 every day
const earlierTriggerToday = hasTriggeredEarlierToday(job);
const laterTriggerToday = willTriggerLaterToday(job);

console.log('Has triggered earlier today:', earlierTriggerToday);
console.log('Will trigger later today:', laterTriggerToday);

[Earu]

Thanks ! That's more or less what I was trying to achieve, do you thinks maybe a similar function could make its way into a future version ? I'm sure I'm not the only one having a use case for checking whether a cron expr is gonna run/has run on a specific date (in my case today).

[Hexagon]

Yep, I'll consider adding a feature like this, just got to figure out how to make is as usable as possible 👍