CronExpressionDescriptor 3.1.0
dotnet add package CronExpressionDescriptor --version 3.1.0
NuGet\Install-Package CronExpressionDescriptor -Version 3.1.0
<PackageReference Include="CronExpressionDescriptor" Version="3.1.0" />
<PackageVersion Include="CronExpressionDescriptor" Version="3.1.0" />
<PackageReference Include="CronExpressionDescriptor" />
paket add CronExpressionDescriptor --version 3.1.0
#r "nuget: CronExpressionDescriptor, 3.1.0"
#:package CronExpressionDescriptor@3.1.0
#addin nuget:?package=CronExpressionDescriptor&version=3.1.0
#tool nuget:?package=CronExpressionDescriptor&version=3.1.0
Cron Expression Descriptor

<img align="left" src="https://user-images.githubusercontent.com/759811/210273710-b13913e2-0a71-4d9d-94da-1fe538b8a73e.gif"/>
<br/>
Would you take a quick second and ⭐️ my repo?
<br/>
A .NET library that converts cron expressions into human readable descriptions.
CronExpressionDescriptor.ExpressionDescriptor.GetDescription("* * * * *");
> "Every minute"
Author: Brady Holt (http://www.geekytidbits.com) License: MIT
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
- Localization with support for 29 languages
- Provides casing options (Sentence case, Title Case, lowercase, etc.)
- Supports Quartz Enterprise Scheduler .NET cron expressions
Demo
https://bradymholt.github.io/cron-expression-descriptor
Download
Cron Expression Descriptor releases can be installed with NuGet.
Package Manager (Visual Studio)
Install-Package CronExpressionDescriptor
.NET CLI
dotnet add package CronExpressionDescriptor
Visit the NuGet Package page for more info.
View Releases for release version history.
Quick Start
CronExpressionDescriptor.ExpressionDescriptor.GetDescription("* * * * *");
> "Every minute"
Options
A CronExpressionDescriptor.Options object can be passed to GetDescription. The following options are available:
- bool ThrowExceptionOnParseError - If exception occurs when trying to parse expression and generate description, whether to throw or catch and output the Exception message as the description. (Default: true)
- bool Verbose - Whether to use a verbose description (Default: false)
- bool DayOfWeekStartIndexZero - Whether to interpret cron expression DOW
1as Sunday or Monday. (Default: true) - ?bool Use24HourTimeFormat - If true, descriptions will use a 24-hour clock (Default: false but some translations will default to true)
- string Locale - The locale to use (Default: "en")
Example usage:
ExpressionDescriptor.GetDescription("0-10 11 * * *", new Options(){
DayOfWeekStartIndexZero = false,
Use24HourTimeFormat = true,
Locale = "fr"
});
i18n
The following language translations are available:
- English - en (Brady Holt)
- Chinese Simplified - zh-Hans (zh-CN) (Star Peng)
- Chinese Traditional - zh-Hant (zh-TW) (Ricky Chiang)
- Czech - cz (Jirka)
- Danish - da (Rasmus Melchior Jacobsen)
- Dutch - nl (TotalMace)
- Finnish - fi (Mikael Rosenberg)
- French - fr (Arnaud TAMAILLON)
- German - de (Michael Schuler)
- Hebrew - he (Ariel Deil)
- Hungarian - hu (Varga Miklós)
- Italian - it (rinaldihno)
- Japanese - ja (Alin Sarivan)
- Korean - ko (Ion Mincu)
- Norwegian - nb (Siarhei Khalipski)
- Persian (Farsi) - fa (A. Bahrami)
- Polish - pl (foka)
- Portuguese (Brazil) - pt-BR (Renato Lima)
- Romanian - ro (Illegitimis)
- Russian - ru (LbISS)
- Slovenian - sl-SI (Jani Bevk)
- Spanish - es (Ivan Santos)
- Spanish (Mexico) - es-MX (Ion Mincu)
- Swedish - sv (roobin)
- Vietnamese - vi (Nguyen Duc Son)
- Turkish - tr (Mustafa SADEDİL)
- Ukrainian - uk (Taras)
- Greek - el (hardra1n)
- Kazakh - kk (hardra1n)
- Kyrgyz - ky (Only Human)
To use one of these translations, pass in the Locale option to GetDescription. For example, to get the description of 0-10 11 * * * in German:
ExpressionDescriptor.GetDescription("0-10 11 * * *", new Options(){ Locale = "de" });
> "Jede Minute zwischen 11:00 und 11:10"
Alternatively, you can call ExpressionDescriptor.SetDefaultLocale("es"); first to set the default locale and then every usage will use this locale by default.
ExpressionDescriptor.SetDefaultLocale("es");
ExpressionDescriptor.GetDescription("*/45 * * * * *");
> "Cada 45 segundos"
ExpressionDescriptor.GetDescription("0-10 11 * * *");
> "Cada minuto entre las 11:00 AM y las 11:10 AM"
CurrentUICulture
If you are targeting a platform that supports .NET Standard >= 2.0, Thread.CurrentUICulture is supported for determining the default locale, without explicitly passing it in with the Locale option, so the following will work:
// .NET Standard >= 2.0 only
CultureInfo myCultureInfo = new CultureInfo("it-IT");
Thread.CurrentThread.CurrentUICulture = myCultureInfo;
ExpressionDescriptor.GetDescription("* * * * *");
> "Ogni minuto"
Reducing build output size
If you don't want to include all supported languages in your project build output, see instructions for setting the SatelliteResourceLanguages property in your project.
.NET Platform Support
The NuGet package contains a library targeting .NET Standard 2.0 and .NET 10.0. This allows the library to be consumed by applications running on the following .NET platforms:
- .NET Core >= 2.0 and .NET >= 5.0
- .NET Framework >= 4.6.1
- Mono >= 5.4
- (More)
If your application is running on a platform that only supports .NET Standard 1.x (e.g. .NET Core 1.x or .NET Framework 4.5), you can use version 2.52.0, the last version targeting .NET Standard 1.1.
If your application is targeting an earlier version of .NET Framework (i.e. 4.0 or 3.5), you can use version 1.21.2 as it has support back to .NET Framework 3.5. To install this version, run Install-Package CronExpressionDescriptor -Version 1.21.2.
Strong Name Signing
If you need an assembly that is signed with a strong name, you can use version 1.21.2 as it is currently the latest version signed with a strong name.
Ports
This library has been ported to several other languages.
- JavaScript - https://github.com/bradymholt/cRonstrue
- Java - https://github.com/RedHogs/cron-parser
- Java - https://github.com/voidburn/cron-expression-descriptor
- Ruby - https://github.com/alpinweis/cronex
- Python - https://github.com/Salamek/cron-descriptor
- PHP - https://github.com/panlatent/cron-expression-descriptor
- Go - https://github.com/lnquy/cron
- Rust - https://github.com/cflockhart/cron-descriptor-rust
- Swift - https://github.com/gooop/cron-descriptor-swift
Frequently Asked Questions
The cron expression I am passing in is not valid and this library is giving strange output. What should I do?
This library does not do full validation of cron expressions and assumes the expression passed in is valid. If you need to validate an expression consider using a library like Cronos.
Does this library support showing the "next" scheduled date?
No, this is not supported.
Examples
ExpressionDescriptor.GetDescription("* * * * *");
"Every minute"
ExpressionDescriptor.GetDescription("*/1 * * * *");
"Every minute"
ExpressionDescriptor.GetDescription("0 0/1 * * * ?");
"Every minute"
ExpressionDescriptor.GetDescription("0 0 * * * ?");
"Every hour"
ExpressionDescriptor.GetDescription("0 0 0/1 * * ?");
"Every hour"
ExpressionDescriptor.GetDescription("0 23 ? * MON-FRI");
"At 11:00 PM, Monday through Friday"
ExpressionDescriptor.GetDescription("* * * * * *");
"Every second"
ExpressionDescriptor.GetDescription("*/45 * * * * *");
"Every 45 seconds"
ExpressionDescriptor.GetDescription("*/5 * * * *");
"Every 5 minutes"
ExpressionDescriptor.GetDescription("0 0/10 * * * ?");
"Every 10 minutes"
ExpressionDescriptor.GetDescription("0 */5 * * * *");
"Every 5 minutes"
ExpressionDescriptor.GetDescription("30 11 * * 1-5");
"At 11:30 AM, Monday through Friday"
ExpressionDescriptor.GetDescription("30 11 * * *");
"At 11:30 AM"
ExpressionDescriptor.GetDescription("0-10 11 * * *");
"Every minute between 11:00 AM and 11:10 AM"
ExpressionDescriptor.GetDescription("* * * 3 *");
"Every minute, only in March"
ExpressionDescriptor.GetDescription("* * * 3,6 *");
"Every minute, only in March and June"
ExpressionDescriptor.GetDescription("30 14,16 * * *");
"At 02:30 PM and 04:30 PM"
ExpressionDescriptor.GetDescription("30 6,14,16 * * *");
"At 06:30 AM, 02:30 PM and 04:30 PM"
ExpressionDescriptor.GetDescription("46 9 * * 1");
"At 09:46 AM, only on Monday"
ExpressionDescriptor.GetDescription("23 12 15 * *");
"At 12:23 PM, on day 15 of the month"
ExpressionDescriptor.GetDescription("23 12 * JAN *");
"At 12:23 PM, only in January"
ExpressionDescriptor.GetDescription("23 12 ? JAN *");
"At 12:23 PM, only in January"
ExpressionDescriptor.GetDescription("23 12 * JAN-FEB *");
"At 12:23 PM, January through February"
ExpressionDescriptor.GetDescription("23 12 * JAN-MAR *");
"At 12:23 PM, January through March"
ExpressionDescriptor.GetDescription("23 12 * * SUN");
"At 12:23 PM, only on Sunday"
ExpressionDescriptor.GetDescription("*/5 15 * * MON-FRI");
"Every 5 minutes, between 03:00 PM and 03:59 PM, Monday through Friday"
ExpressionDescriptor.GetDescription("* * * * MON#3");
"Every minute, on the third Monday of the month"
ExpressionDescriptor.GetDescription("* * * * 4L");
"Every minute, on the last Thursday of the month"
ExpressionDescriptor.GetDescription("*/5 * L JAN *");
"Every 5 minutes, on the last day of the month, only in January"
ExpressionDescriptor.GetDescription("30 02 14 * * *");
"At 02:02:30 PM"
ExpressionDescriptor.GetDescription("5-10 * * * * *");
"Seconds 5 through 10 past the minute"
ExpressionDescriptor.GetDescription("5-10 30-35 10-12 * * *");
"Seconds 5 through 10 past the minute, minutes 30 through 35 past the hour, between 10:00 AM and 12:00 PM"
ExpressionDescriptor.GetDescription("30 */5 * * * *");
"At 30 seconds past the minute, every 05 minutes"
ExpressionDescriptor.GetDescription("0 30 10-13 ? * WED,FRI");
"At 30 minutes past the hour, between 10:00 AM and 01:00 PM, only on Wednesday and Friday"
ExpressionDescriptor.GetDescription("10 0/5 * * * ?");
"At 10 seconds past the minute, every 05 minutes"
ExpressionDescriptor.GetDescription("2-59/3 1,9,22 11-26 1-6 ?");
"Every 03 minutes, minutes 2 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("0 0 6 1/1 * ?");
"At 06:00 AM"
ExpressionDescriptor.GetDescription("0 5 0/1 * * ?");
"At 05 minutes past the hour"
ExpressionDescriptor.GetDescription("* * * * * * 2013");
"Every second, only in 2013"
ExpressionDescriptor.GetDescription("* * * * * 2013");
"Every minute, only in 2013"
ExpressionDescriptor.GetDescription("* * * * * 2013,2014");
"Every minute, only in 2013 and 2014"
ExpressionDescriptor.GetDescription("23 12 * JAN-FEB * 2013-2014");
"At 12:23 PM, January through February, 2013 through 2014"
ExpressionDescriptor.GetDescription("23 12 * JAN-MAR * 2013-2015");
"At 12:23 PM, January through March, 2013 through 2015"
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- No dependencies.
-
net10.0
- No dependencies.
NuGet packages (53)
Showing the top 5 NuGet packages that depend on CronExpressionDescriptor:
| Package | Downloads |
|---|---|
|
Hangfire.Dashboard.Management
Hangfire.Dashboard.Management provides a Management page in the default dashboard. It allows for manually creating jobs. |
|
|
AMS-Utl
Package Description |
|
|
DotNetWorkQueue
Work queue for dot net 8.0 and 10.0, and for .NET Framework and other netstandard2.0 runtimes. Supports scheduling, delayed processing, prioritized queues, message expiration, retries with configurable back-off and more. |
|
|
BlueBox.Core
Core Framework |
|
|
Aurora.Workflows
Aurora Workflows core engine: visual workflow automation for .NET with Roslyn-powered C# expressions, explicit task inputs/outputs, triggers and headless execution of .awf workflows. Designer-independent and embeddable in any .NET application. |
GitHub repositories (15)
Showing the top 15 popular GitHub repositories that depend on CronExpressionDescriptor:
| Repository | Stars |
|---|---|
|
HangfireIO/Hangfire
An easy way to perform background job processing in .NET and .NET Core applications. No Windows Service or separate process required
|
|
|
RayWangQvQ/BiliBiliToolPro
B 站(bilibili)自动任务工具,支持docker、青龙、k8s等多种部署方式。全面拥抱AI。敏感肌也能用。
|
|
|
smartstore/SmartStoreNET
Open Source ASP.NET MVC Enterprise eCommerce Shopping Cart Solution
|
|
|
smartstore/Smartstore
A modular, scalable and ultra-fast open-source all-in-one eCommerce platform built on ASP.NET Core 10
|
|
|
simpleidserver/SimpleIdServer
OpenID, OAuth 2.0, SCIM2.0, UMA2.0, FAPI, CIBA & OPENBANKING Framework for ASP.NET Core
|
|
|
nsnail/NetAdmin
通用后台权限管理系统、快速开发框架(基于C#13/.NET9、Vue3/Vite、ElementPlus等现代技术构建,具有十分整洁、优雅的编码规范)Universal backend permission management system, rapid development framework (based on modern technologies such as C#13/.NET9, Vue3/Vite, ElementPlus, etc., with very neat and elegant coding standards)
|
|
|
trimble-oss/dba-dash
DBA Dash - SQL Server Monitoring Tool
|
|
|
Corsinvest/cv4pve-admin
Web management platform for Proxmox VE clusters: like vCenter but for Proxmox
|
|
|
hupo376787/WeiboAlbumDownloader
微博相册下载工具C#版,批量采集指定微博账号下的所有图片/视频/LivePhoto。
|
|
|
tomkerkhove/promitor
Bringing Azure Monitor metrics where you need them.
|
|
|
yuzd/Hangfire.Core.Extend
在1.6.5基础上给dashbord增加了搜索功能,增加在dashbord上手动添加job,提供对外SDK添加job
|
|
|
mausch/QuartzNetWebConsole
Embeddable Quartz.Net web console
|
|
|
wilchn/BlazingQuartz
Blazor web UI to manage Quartz.NET scheduler jobs.
|
|
|
blehnen/DotNetWorkQueue
A work queue for dot.net with SQL server, SQLite, LiteDB, Redis and PostGreSQL backends
|
|
|
DevToys-app/DevToys.Tools
Default tools shipped with DevToys
|
| Version | Downloads | Last Updated |
|---|---|---|
| 3.1.0 | 0 | 11/19/2026 |
| 3.0.0 | 0 | 11/19/2026 |
| 2.53.0 | 0 | 11/19/2026 |
| 2.52.0 | 368 | 11/18/2026 |
| 2.51.0 | 912,995 | 7/7/2026 |
| 2.50.0 | 199,689 | 6/8/2026 |
| 2.49.0 | 1,523 | 6/8/2026 |
| 2.48.0 | 76,895 | 5/28/2026 |
| 2.47.0 | 740 | 5/28/2026 |
| 2.46.0 | 735 | 5/28/2026 |
| 2.45.0 | 765,708 | 2/25/2026 |
| 2.44.0 | 1,432,906 | 7/3/2025 |
| 2.43.0 | 3,564 | 7/3/2025 |
| 2.42.0 | 4,595 | 7/3/2025 |
| 2.41.0 | 558,039 | 4/17/2025 |
| 2.40.0 | 75,545 | 4/7/2025 |
| 2.39.0 | 673,441 | 3/10/2025 |
| 2.38.0 | 457,622 | 1/2/2025 |
| 2.37.0 | 3,847 | 1/2/2025 |
| 2.36.0 | 1,139,004 | 7/15/2024 |
See https://github.com/bradymholt/cron-expression-descriptor/releases for release notes