puchaczov/tql.cronexpression

Advanced cron evaluator

CronExpression

What is CronExpression

CronExpression is .NET CRON expression validator and fire time evaluator. It pretend to support the broadest spectrum of available syntax. It’s even powerful enough to point why you’re expression is wrong!

Latest release

Version 3.0

• Support mixable complex types such as L, LW, W, #, -(range), /(Hyphen), *(star) in defined by CRON rules segment

• Support expression in two modes: Modern(with second and year segment), Old(without second and year segment)

• Improved expression analysis.

• Support for nonstandard defintions

• Nuget availibility (Install-Package TQL.CronExpression)

Features

Typing expression is allowed in two formats, standard and nonstandard.

Supported nonstandard definitions are:

• @annual

• @yearly

• @monthly

• @weekly

• @daily

• @hourly

Standard definitions are:

Feature	Parser	Expression Validator	Evaluator
*	Supported	Supported	Supported
,	Supported	Supported	Supported
-	Supported	Supported	Supported
/	Supported	Supported	Supported
?	Supported	Supported(DayOfMonth,DayOfWeek)	Supported(DayOfMonth,DayOfWeek)
L	Supported	Supported	Supported
W	Supported	Supported(DayOfMonth)	Supported(DayOfMonth)
LW	Supported	Supported(DayOfMonth)	Supported(DayOfMonth)
#	Supported	Supported(DayOfWeek)	Supported(DayOfWeek)
Errors	Supported	Supported	Not Applicable

 

API & Documentation

To successfully use this library, you won’t need to learn a lot, just read short introduction in appropriate section of documentation (go here). If you would like to bring something new to library, open new issue.

Contribute

If you like this library, please appreciate my effort. You can do it by creating fixes, new features, reporting issues or starring library. Feel free to report ideas, It's good place to consider implementation of it.

License

This library is based on MIT license.

tql.cronexpression's Issues

Performance fix - evaluate some cron expressions

Find out why some of tests performs much longer than others.

Cron.Visitors - refactorization required

this whole project requires refactorization.

L Option feature - Parser

Allows L option to be defined as L-n. It should be called one day before last day of month.

L Option feature - Evaluator

Allows L option to be defined as L-n. It should be called one day before last day of month.

Support reccurence expressions

Changes in RecurrenceDescriptiveLanguage branch,

Evaluate next fire times in past direction

Feature is currently not implemented.

Allow compiled expression to have replaced referenceTime

ReferenceTime should be replaceable to let evaluate NextFire() after such referenceTime.

Quartz.NET - analysis and integration

Analysis & integration -

To consider is: how replace Quartz.NET default CRON implementation (ICronFireTimeEvaluator will need to be extended)

IsSatisfiedBy(...) compare DateTime with milliseconds precision

Any expression that will be tested with millisecond precision will fail, it won't be equal with generated date without milliseconds part of time,

Add support for .NET Core

Nullable DateTime in evaluator

When expression point to last possible date, another call of NextFire() must return null instead of throwing exception.

Create Nuget package

After 1.0 release

Siblings and Parents for AST

Possibility of finding siblings and parent of node

When CRON expression is wrong - meaningfull errors

Compilation of CRON expression should produce meaningfull messages in case of error.

Release 1.0 require this feature.