/aws-cron-parser

A util to parse cron expressions used by AWS services

Primary LanguageTypeScript

AWS Cron Parser

npm circleci benchmark codacy

This utility was built to process AWS Cron Expressions used by Amazon CloudWatch. It can support all the specs listed in the link below, including the special wildcards L W and #.

Specs

AWS Cron Expression specs

Installation

npm install aws-cron-parser

Usage

There are only 3 methods: parse, next, and prev

import awsCronParser from "aws-cron-parser";

// first we need to parse the cron expression
const cron = awsCronParser.parse("9 * 7,9,11 5 ? 2020,2022,2024-2099");

// to get the first occurrence from now
let occurrence = awsCronParser.next(cron, new Date());

// to get the next occurrence following the previous one
occurrence = awsCronParser.next(cron, occurrence);

// and use prev to get the previous occurrence
occurrence = awsCronParser.prev(cron, occurrence);