This forked from bradyholt/cron-expression-descriptor is a C# library that converts cron (Quartz.NET) expressions into localized human readable strings. The languages availabe are:
- English (Brady Holt)
- Brazilian (Renato Lima)
- Spanish (Ivan Santos)
Author: Brady Holt (http://www.geekytidbits.com)
License: MIT
Online Demo (only english)
http://www.geekytidbits.com/cron-expression-descriptor-demo/
Features
- Supports all cron expression special characters including * / , - ? L W, #.
- Supports 5, 6 (w/ seconds or year), or 7 (w/ seconds and year) part cron expressions.
- Provides casing options (Sentence, Title, Lower, etc.)
Download
If you want to get up and running quickly and just want the library in english, visit the Downloads page and download the latest CronExpressionDescriptor.dll library assembly.
Usage Examples (as Unit Tests)
[TestMethod]
public void TestEveryMinute()
{
Assert.AreEqual("Every minute", ExpressionDescriptor.GetDescription("* * * * *"));
}
[TestMethod]
public void TestEvery1Minute()
{
Assert.AreEqual("Every minute", ExpressionDescriptor.GetDescription("*/1 * * * *"));
Assert.AreEqual("Every minute", ExpressionDescriptor.GetDescription("0 0/1 * * * ?"));
}
[TestMethod]
public void TestEveryHour()
{
Assert.AreEqual("Every hour", ExpressionDescriptor.GetDescription("0 0 * * * ?"));
Assert.AreEqual("Every hour", ExpressionDescriptor.GetDescription("0 0 0/1 * * ?"));
}
[TestMethod]
public void TestTimeOfDayCertainDaysOfWeek()
{
Assert.AreEqual("At 11:00 PM, Monday through Friday", ExpressionDescriptor.GetDescription("0 23 ? * MON-FRI"));
}
[TestMethod]
public void TestEverySecond()
{
Assert.AreEqual("Every second", ExpressionDescriptor.GetDescription("* * * * * *"));
}
[TestMethod]
public void TestEvery45Seconds()
{
Assert.AreEqual("Every 45 seconds", ExpressionDescriptor.GetDescription("*/45 * * * * *"));
}
[TestMethod]
public void TestEvery5Minutes()
{
Assert.AreEqual("Every 05 minutes", ExpressionDescriptor.GetDescription("*/5 * * * *"));
Assert.AreEqual("Every 10 minutes", ExpressionDescriptor.GetDescription("0 0/10 * * * ?"));
}
[TestMethod]
public void TestEvery5MinutesOnTheSecond()
{
Assert.AreEqual("Every 05 minutes", ExpressionDescriptor.GetDescription("0 */5 * * * *"));
}
[TestMethod]
public void TestWeekdaysAtTime()
{
Assert.AreEqual("At 11:30 AM, Monday through Friday", ExpressionDescriptor.GetDescription("30 11 * * 1-5"));
}
[TestMethod]
public void TestDailyAtTime()
{
Assert.AreEqual("At 11:30 AM", ExpressionDescriptor.GetDescription("30 11 * * *"));
}
[TestMethod]
public void TestMinuteSpan()
{
Assert.AreEqual("Every minute between 11:00 AM and 11:10 AM", ExpressionDescriptor.GetDescription("0-10 11 * * *"));
}
[TestMethod]
public void TestOneMonthOnly()
{
Assert.AreEqual("Every minute, only in March", ExpressionDescriptor.GetDescription("* * * 3 *"));
}
[TestMethod]
public void TestTwoMonthsOnly()
{
Assert.AreEqual("Every minute, only in March and June", ExpressionDescriptor.GetDescription("* * * 3,6 *"));
}
[TestMethod]
public void TestTwoTimesEachAfternoon()
{
Assert.AreEqual("At 02:30 PM and 04:30 PM", ExpressionDescriptor.GetDescription("30 14,16 * * *"));
}
[TestMethod]
public void TestThreeTimesDaily()
{
Assert.AreEqual("At 06:30 AM, 02:30 PM and 04:30 PM", ExpressionDescriptor.GetDescription("30 6,14,16 * * *"));
}
[TestMethod]
public void TestOnceAWeek()
{
Assert.AreEqual("At 09:46 AM, only on Monday", ExpressionDescriptor.GetDescription("46 9 * * 1"));
}
[TestMethod]
public void TestDayOfMonth()
{
Assert.AreEqual("At 12:23 PM, on day 15 of the month", ExpressionDescriptor.GetDescription("23 12 15 * *"));
}
[TestMethod]
public void TestMonthName()
{
Assert.AreEqual("At 12:23 PM, only in January", ExpressionDescriptor.GetDescription("23 12 * JAN *"));
}
[TestMethod]
public void TestDayOfMonthWithQuestionMark()
{
Assert.AreEqual("At 12:23 PM, only in January", ExpressionDescriptor.GetDescription("23 12 ? JAN *"));
}
[TestMethod]
public void TestMonthNameRange2()
{
Assert.AreEqual("At 12:23 PM, January through February", ExpressionDescriptor.GetDescription("23 12 * JAN-FEB *"));
}
[TestMethod]
public void TestMonthNameRange3()
{
Assert.AreEqual("At 12:23 PM, January through March", ExpressionDescriptor.GetDescription("23 12 * JAN-MAR *"));
}
[TestMethod]
public void TestDayOfWeekName()
{
Assert.AreEqual("At 12:23 PM, only on Sunday", ExpressionDescriptor.GetDescription("23 12 * * SUN"));
}
[TestMethod]
public void TestDayOfWeekRange()
{
Assert.AreEqual("Every 05 minutes, at 03:00 PM, Monday through Friday", ExpressionDescriptor.GetDescription("*/5 15 * * MON-FRI"));
}
[TestMethod]
public void TestDayOfWeekOnceInMonth()
{
Assert.AreEqual("Every minute, on the third Monday of the month", ExpressionDescriptor.GetDescription("* * * * MON#3"));
}
[TestMethod]
public void TestLastDayOfTheWeekOfTheMonth()
{
Assert.AreEqual("Every minute, on the last Thursday of the month", ExpressionDescriptor.GetDescription("* * * * 4L"));
}
[TestMethod]
public void TestLastDayOfTheMonth()
{
Assert.AreEqual("Every 05 minutes, on the last day of the month, only in January", ExpressionDescriptor.GetDescription("*/5 * L JAN *"));
}
[TestMethod]
public void TestTimeOfDayWithSeconds()
{
Assert.AreEqual("At 02:02:30 PM", ExpressionDescriptor.GetDescription("30 02 14 * * *"));
}
[TestMethod]
public void TestSecondInternvals()
{
Assert.AreEqual("Seconds 05 through 10 past the minute", ExpressionDescriptor.GetDescription("5-10 * * * * *"));
}
[TestMethod]
public void TestSecondMinutesHoursIntervals()
{
Assert.AreEqual("Seconds 05 through 10 past the minute, minutes 30 through 35 past the hour, between 10:00 AM and 12:00 PM", ExpressionDescriptor.GetDescription("5-10 30-35 10-12 * * *"));
}
[TestMethod]
public void TestEvery5MinutesAt30Seconds()
{
Assert.AreEqual("At 30 seconds past the minute, every 05 minutes", ExpressionDescriptor.GetDescription("30 */5 * * * *"));
}
[TestMethod]
public void TestMinutesPastTheHourRange()
{
Assert.AreEqual("At 30 minutes past the hour, between 10:00 AM and 01:00 PM, only on Wednesday and Friday", ExpressionDescriptor.GetDescription("0 30 10-13 ? * WED,FRI"));
}
[TestMethod]
public void TestSecondsPastTheMinuteInterval()
{
Assert.AreEqual("At 10 seconds past the minute, every 05 minutes", ExpressionDescriptor.GetDescription("10 0/5 * * * ?"));
}
[TestMethod]
public void TestBetweenWithInterval()
{
Assert.AreEqual("Every 03 minutes, minutes 02 through 59 past the hour, at 01:00 AM, 09:00 AM, and 10:00 PM, between day 11 and 26 of the month, January through June", ExpressionDescriptor.GetDescription("2-59/3 1,9,22 11-26 1-6 ?"));
}
[TestMethod]
public void TestRecurringFirstOfMonth()
{
Assert.AreEqual("At 06:00 AM", ExpressionDescriptor.GetDescription("0 0 6 1/1 * ?"));
}
[TestMethod]
public void TestMinutesPastTheHour()
{
Assert.AreEqual("At 05 minutes past the hour", ExpressionDescriptor.GetDescription("0 5 0/1 * * ?"));
}
[TestMethod]
public void TestOneYearOnlyWithSeconds()
{
Assert.AreEqual("Every second, only in 2013", ExpressionDescriptor.GetDescription("* * * * * * 2013"));
}
[TestMethod]
public void TestOneYearOnlyWithoutSeconds()
{
Assert.AreEqual("Every minute, only in 2013", ExpressionDescriptor.GetDescription("* * * * * 2013"));
}
[TestMethod]
public void TestTwoYearsOnly()
{
Assert.AreEqual("Every minute, only in 2013 and 2014", ExpressionDescriptor.GetDescription("* * * * * 2013,2014"));
}
[TestMethod]
public void TestYearRange2()
{
Assert.AreEqual("At 12:23 PM, January through February, 2013 through 2014", ExpressionDescriptor.GetDescription("23 12 * JAN-FEB * 2013-2014"));
}
[TestMethod]
public void TestYearRange3()
{
Assert.AreEqual("At 12:23 PM, January through March, 2013 through 2015", ExpressionDescriptor.GetDescription("23 12 * JAN-MAR * 2013-2015"));
}