@robinpath/cron

Cron expression parsing, validation, scheduling, and human-readable descriptions

Why use this module?

The cron module lets you:

• Validate a cron expression
• Parse cron expression into expanded fields
• Get next occurrence after a date
• Get next N occurrences
• Get previous occurrence before a date

All functions are callable directly from RobinPath scripts with a simple, consistent API.

Installation

npm install @robinpath/cron

Quick Start

No credentials needed — start using it right away:

cron.parse "0 9 * * 1-5"

Available Functions

| Function | Description | |----------|-------------| | cron.isValid | Validate a cron expression | | cron.parse | Parse cron expression into expanded fields | | cron.next | Get next occurrence after a date | | cron.nextN | Get next N occurrences | | cron.prev | Get previous occurrence before a date | | cron.matches | Check if a date matches a cron expression | | cron.describe | Human-readable description of a cron expression | | cron.between | Get all occurrences between two dates |

Examples

Parse cron expression into expanded fields

cron.parse "0 9 * * 1-5"

Get next occurrence after a date

cron.next "*/5 * * * *"

Get next N occurrences

cron.nextN "0 * * * *" 10

Integration with RobinPath

import { RobinPath } from "@wiredwp/robinpath";
import Module from "@robinpath/cron";

const rp = new RobinPath();
rp.registerModule(Module.name, Module.functions);
rp.registerModuleMeta(Module.name, Module.functionMetadata);

const result = await rp.executeScript(`
  cron.parse "0 9 * * 1-5"
`);

Full API Reference

See MODULE.md for complete documentation including all parameters, return types, error handling, and advanced examples.

Related Modules

• @robinpath/json — JSON module for complementary functionality

License

MIT