Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/atifaziz/NCrontab

Crontab for .NET
https://github.com/atifaziz/NCrontab

crontab dotnet hacktoberfest schedule

Last synced: about 1 month ago
JSON representation

Crontab for .NET

Host: GitHub
URL: https://github.com/atifaziz/NCrontab
Owner: atifaziz
License: apache-2.0
Created: 2015-08-19T15:57:20.000Z (almost 9 years ago)
Default Branch: master
Last Pushed: 2023-09-26T11:37:48.000Z (8 months ago)
Last Synced: 2024-05-02T11:18:02.082Z (about 1 month ago)
Topics: crontab, dotnet, hacktoberfest, schedule
Language: C#
Homepage:
Size: 668 KB
Stars: 868
Watchers: 24
Forks: 134
Open Issues: 25
Metadata Files:
- Readme: README.md
- License: COPYING.txt

Lists

awesome-dotnet - NCrontab - Class library for parsing & formatting [crontab](http://crontab.org/) expressions as well as calculating occurrences of time based on a crontab schedule (Scheduling)
awesome-dotnet-core - NCrontab - Crontab for .NET. (Frameworks, Libraries and Tools / Scheduler and Job)
awsome-dotnet - NCrontab - Class library for parsing & formatting [crontab](http://crontab.org/) expressions as well as calculating occurrences of time based on a crontab schedule (Scheduling)
awesome-stars - NCrontab
awesome-dotnet-core - NCrontab - 用于.NET的Crontab。 (框架, 库和工具 / 任务计划)
awesome-dotnet - NCrontab - Class library for parsing & formatting [crontab](http://crontab.org/) expressions as well as calculating occurrences of time based on a crontab schedule (Scheduling)
awesome-dot-dev - NCrontab - Class library for parsing & formatting [crontab](http://crontab.org/) expressions as well as calculating occurrences of time based on a crontab schedule (Scheduling)
awesome-dotnet - NCrontab - Class library for parsing & formatting [crontab](http://crontab.org/) expressions as well as calculating occurrences of time based on a crontab schedule (Scheduling)
awesome-dotnet-core - NCrontab - Crontab for .NET. (Frameworks, Libraries and Tools / Scheduler and Job)
awesome-dotnet-core - NCrontab - Crontab for .NET. (Frameworks, Libraries and Tools / Scheduler and Job)
awesome-dotnet - NCrontab - Class library for parsing & formatting [crontab](http://crontab.org/) expressions as well as calculating occurrences of time based on a crontab schedule (Scheduling)
awesome-dotnet - NCrontab - Class library for parsing & formatting [crontab](http://crontab.org/) expressions as well as calculating occurrences of time based on a crontab schedule (Scheduling)
awesome-csharp - NCrontab - Class library for parsing & formatting [crontab](http://crontab.org/) expressions as well as calculating occurrences of time based on a crontab schedule (Scheduling)
awesome-dotnet-core-master - NCrontab - Crontab for .NET. (Frameworks, Libraries and Tools / Scheduler and Job)
awesome-dotnet - NCrontab - Class library for parsing & formatting [crontab](http://crontab.org/) expressions as well as calculating occurrences of time based on a crontab schedule (Scheduling)
awesome-dotnet-core - NCrontab - Crontab for .NET. (Frameworks, Libraries and Tools / Scheduler and Job)
system-architecture-awesome - NCrontab - Class library for parsing & formatting [crontab](http://crontab.org/) expressions as well as calculating occurrences of time based on a crontab schedule (Scheduling)
awesome-dotnet-core - NCrontab - Crontab for .NET. (Frameworks, Libraries and Tools / Scheduler and Job)
awesome-dotnet-cn - NCrontab - 用于解析和格式化[crontab](http://crontab.org/)表达式的类库，以及基于设定时程表(crontab schedule)来计算发生的时间。 (计划调度)
awesome-dotnet - NCrontab - Class library for parsing & formatting [crontab](http://crontab.org/) expressions as well as calculating occurrences of time based on a crontab schedule (Scheduling)
awesome-dotnet-core - NCrontab - Crontab for .NET. (Frameworks, Libraries and Tools / Scheduler and Job)
awesome-dotnet - NCrontab - Class library for parsing & formatting [crontab](http://crontab.org/) expressions as well as calculating occurrences of time based on a crontab schedule (Scheduling)
awesome-dotnet-core - NCrontab - Crontab for .NET. (Frameworks, Libraries and Tools / Scheduler and Job)

README

        # NCrontab: Crontab for .NET

[![Build Status][build-badge]][builds]

[![NuGet][nuget-badge]][nuget-pkg]

NCrontab is a library written in C# targeting [.NET Standard Library][netstd]

1.0 and that provides the following facilities:

* Parsing of crontab expressions

* Formatting of crontab expressions

* Calculation of occurrences of time based on a crontab schedule

This library does not provide any scheduler or is not a scheduling facility like

cron from Unix platforms. What it provides is parsing, formatting and an algorithm

to produce occurrences of time based on a give schedule expressed in the crontab

format:

    * * * * *

    - - - - -

    | | | | |

    | | | | +----- day of week (0 - 6) (Sunday=0)

    | | | +------- month (1 - 12)

    | | +--------- day of month (1 - 31)

    | +----------- hour (0 - 23)

    +------------- min (0 - 59)

or a six-part format that allows for seconds:

    * * * * * *

    - - - - - -

    | | | | | |

    | | | | | +--- day of week (0 - 6) (Sunday=0)

    | | | | +----- month (1 - 12)

    | | | +------- day of month (1 - 31)

    | | +--------- hour (0 - 23)

    | +----------- min (0 - 59)

    +------------- sec (0 - 59)

Star (`*`) in the value field above means all legal values as in parentheses for

that column. The value column can have a `*` or a list of elements separated by

commas. An element is either a number in the ranges shown above or two numbers in

the range separated by a hyphen (meaning an inclusive range). For more, see

[CrontabExpression].

Below is an example in [IronPython][ipy] of how to use `CrontabSchedule` class

from NCrontab to generate occurrences of the schedule `0 12 * */2 Mon`

(meaning, *12:00 PM on Monday of every other month, starting with January*)

throughout the year 2000:

    IronPython 1.1 (1.1) on .NET 2.0.50727.1434

    Copyright (c) Microsoft Corporation. All rights reserved.

    >>> import clr

    >>> clr.AddReferenceToFileAndPath(r'C:\NCrontab\bin\Release\NCrontab.dll')

    >>> from System import DateTime

    >>> from NCrontab import CrontabSchedule

    >>> s = CrontabSchedule.Parse('0 12 * */2 Mon')

    >>> start = DateTime(2000, 1, 1)

    >>> end = start.AddYears(1)

    >>> occurrences = s.GetNextOccurrences(start, end)

    >>> print '\n'.join([t.ToString('ddd, dd MMM yyyy HH:mm') for t in occurrences])

    Mon, 03 Jan 2000 12:00

    Mon, 10 Jan 2000 12:00

    Mon, 17 Jan 2000 12:00

    Mon, 24 Jan 2000 12:00

    Mon, 31 Jan 2000 12:00

    Mon, 06 Mar 2000 12:00

    Mon, 13 Mar 2000 12:00

    Mon, 20 Mar 2000 12:00

    Mon, 27 Mar 2000 12:00

    Mon, 01 May 2000 12:00

    Mon, 08 May 2000 12:00

    Mon, 15 May 2000 12:00

    Mon, 22 May 2000 12:00

    Mon, 29 May 2000 12:00

    Mon, 03 Jul 2000 12:00

    Mon, 10 Jul 2000 12:00

    Mon, 17 Jul 2000 12:00

    Mon, 24 Jul 2000 12:00

    Mon, 31 Jul 2000 12:00

    Mon, 04 Sep 2000 12:00

    Mon, 11 Sep 2000 12:00

    Mon, 18 Sep 2000 12:00

    Mon, 25 Sep 2000 12:00

    Mon, 06 Nov 2000 12:00

    Mon, 13 Nov 2000 12:00

    Mon, 20 Nov 2000 12:00

    Mon, 27 Nov 2000 12:00

Below is the same example in [F#][f#] Interactive (`fsi.exe`):

    Microsoft (R) F# 2.0 Interactive build 4.0.40219.1

    Copyright (c) Microsoft Corporation. All Rights Reserved.

    For help type #help;;

    > #r "NCrontab.dll"

    -

    - open NCrontab

    - open System

    -

    - let schedule = CrontabSchedule.Parse("0 12 * */2 Mon")

    - let startDate = DateTime(2000, 1, 1)

    - let endDate = startDate.AddYears(1)

    -

    - let occurrences = schedule.GetNextOccurrences(startDate, endDate)

    - occurrences |> Seq.map (fun t -> t.ToString("ddd, dd MMM yyy HH:mm"))

    -             |> String.concat "\n"

    -             |> printfn "%s";;

    --> Referenced 'C:\NCrontab\bin\Release\NCrontab.dll'

    Mon, 03 Jan 2000 12:00

    Mon, 10 Jan 2000 12:00

    Mon, 17 Jan 2000 12:00

    Mon, 24 Jan 2000 12:00

    Mon, 31 Jan 2000 12:00

    Mon, 06 Mar 2000 12:00

    Mon, 13 Mar 2000 12:00

    Mon, 20 Mar 2000 12:00

    Mon, 27 Mar 2000 12:00

    Mon, 01 May 2000 12:00

    Mon, 08 May 2000 12:00

    Mon, 15 May 2000 12:00

    Mon, 22 May 2000 12:00

    Mon, 29 May 2000 12:00

    Mon, 03 Jul 2000 12:00

    Mon, 10 Jul 2000 12:00

    Mon, 17 Jul 2000 12:00

    Mon, 24 Jul 2000 12:00

    Mon, 31 Jul 2000 12:00

    Mon, 04 Sep 2000 12:00

    Mon, 11 Sep 2000 12:00

    Mon, 18 Sep 2000 12:00

    Mon, 25 Sep 2000 12:00

    Mon, 06 Nov 2000 12:00

    Mon, 13 Nov 2000 12:00

    Mon, 20 Nov 2000 12:00

    Mon, 27 Nov 2000 12:00

Below is the same example in C# Interactive (`csi.exe`):

    Microsoft (R) Visual C# Interactive Compiler version 1.2.0.60317

    Copyright (C) Microsoft Corporation. All rights reserved.

    Type "#help" for more information.

    > #r "NCrontab.dll"

    > using NCrontab;

    > var s = CrontabSchedule.Parse("0 12 * */2 Mon");

    > var start = new DateTime(2000, 1, 1);

    > var end = start.AddYears(1);

    > var occurrences = s.GetNextOccurrences(start, end);

    > Console.WriteLine(string.Join(Environment.NewLine,

    .     from t in occurrences

    .     select $"{t:ddd, dd MMM yyyy HH:mm}"));

    Mon, 03 Jan 2000 12:00

    Mon, 10 Jan 2000 12:00

    Mon, 17 Jan 2000 12:00

    Mon, 24 Jan 2000 12:00

    Mon, 31 Jan 2000 12:00

    Mon, 06 Mar 2000 12:00

    Mon, 13 Mar 2000 12:00

    Mon, 20 Mar 2000 12:00

    Mon, 27 Mar 2000 12:00

    Mon, 01 May 2000 12:00

    Mon, 08 May 2000 12:00

    Mon, 15 May 2000 12:00

    Mon, 22 May 2000 12:00

    Mon, 29 May 2000 12:00

    Mon, 03 Jul 2000 12:00

    Mon, 10 Jul 2000 12:00

    Mon, 17 Jul 2000 12:00

    Mon, 24 Jul 2000 12:00

    Mon, 31 Jul 2000 12:00

    Mon, 04 Sep 2000 12:00

    Mon, 11 Sep 2000 12:00

    Mon, 18 Sep 2000 12:00

    Mon, 25 Sep 2000 12:00

    Mon, 06 Nov 2000 12:00

    Mon, 13 Nov 2000 12:00

    Mon, 20 Nov 2000 12:00

    Mon, 27 Nov 2000 12:00

Below is the same example in C# using [`dotnet-script`][dotnet-script]:

    > #r "nuget:NCrontab"

    > using NCrontab;

    > var s = CrontabSchedule.Parse("0 12 * */2 Mon");

    > var start = new DateTime(2000, 1, 1);

    > var end = start.AddYears(1);

    > var occurrences = s.GetNextOccurrences(start, end);

    > Console.WriteLine(string.Join(Environment.NewLine,

    *     from t in occurrences

    *     select $"{t:ddd, dd MMM yyyy HH:mm}"));

    Mon, 03 Jan 2000 12:00

    Mon, 10 Jan 2000 12:00

    Mon, 17 Jan 2000 12:00

    Mon, 24 Jan 2000 12:00

    Mon, 31 Jan 2000 12:00

    Mon, 06 Mar 2000 12:00

    Mon, 13 Mar 2000 12:00

    Mon, 20 Mar 2000 12:00

    Mon, 27 Mar 2000 12:00

    Mon, 01 May 2000 12:00

    Mon, 08 May 2000 12:00

    Mon, 15 May 2000 12:00

    Mon, 22 May 2000 12:00

    Mon, 29 May 2000 12:00

    Mon, 03 Jul 2000 12:00

    Mon, 10 Jul 2000 12:00

    Mon, 17 Jul 2000 12:00

    Mon, 24 Jul 2000 12:00

    Mon, 31 Jul 2000 12:00

    Mon, 04 Sept 2000 12:00

    Mon, 11 Sept 2000 12:00

    Mon, 18 Sept 2000 12:00

    Mon, 25 Sept 2000 12:00

    Mon, 06 Nov 2000 12:00

    Mon, 13 Nov 2000 12:00

    Mon, 20 Nov 2000 12:00

    Mon, 27 Nov 2000 12:00

---

This product includes software developed by the [OpenSymphony Group].

  [CrontabExpression]: https://github.com/atifaziz/NCrontab/wiki/Crontab-Expression

  [ipy]: http://en.wikipedia.org/wiki/IronPython

  [f#]: http://msdn.microsoft.com/en-us/fsharp/cc742182

  [build-badge]: https://img.shields.io/appveyor/ci/raboof/ncrontab/master.svg

  [nuget-badge]: https://img.shields.io/nuget/v/ncrontab.svg

  [nuget-pkg]: https://www.nuget.org/packages/ncrontab

  [builds]: https://ci.appveyor.com/project/raboof/ncrontab

  [netstd]: https://docs.microsoft.com/en-us/dotnet/articles/standard/library

  [dotnet-script]: https://github.com/dotnet-script/dotnet-script

  [OpenSymphony Group]: http://www.opensymphony.com/