Display cron runspecs in human-readable format

npm install prettycron
6 downloads in the last week
17 downloads in the last month


prettyCron is a simple JavaScript deuglifier for cron schedules: it prints out a human-readable interpretation of when the schedule will run.

Perhaps you'd like to check out the examples!

Installation - browser

Include prettycron.js after adding moment.js and later.js (only later-cron.js is required).

<script src="moment.min.js" type="text/javascript"></script>
<script src="later-cron.min.js" type="text/javascript"></script>
<script src="prettycron.js" type="text/javascript"></script>

Installation - Node

Simply use npm and require:

$ npm install prettycron
var prettyCron = require('prettycron');


prettyCron exposes two methods, both of which take a cron specification as the only argument.


Returns a human-readable sentence describing all the times this cron will run.

prettyCron.toString("37 10 * * * *");
// returns "10:37 every day"


Returns a string representing the next time this cron will run, formatted with moment's calendar() method.

prettyCron.getNext("0 * * * *");
// if current time is 4:45pm, then returns "Today at 5:00 PM"


prettyCron was originally written by dunse and posted to gist. It's licensed under LGPLv3.

prettyCron depends on:

npm loves you