SmartDateRangeParser 1.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package SmartDateRangeParser --version 1.0.0
                    
NuGet\Install-Package SmartDateRangeParser -Version 1.0.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SmartDateRangeParser" Version="1.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SmartDateRangeParser" Version="1.0.0" />
                    
Directory.Packages.props
<PackageReference Include="SmartDateRangeParser" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add SmartDateRangeParser --version 1.0.0
                    
#r "nuget: SmartDateRangeParser, 1.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package SmartDateRangeParser@1.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=SmartDateRangeParser&version=1.0.0
                    
Install as a Cake Addin
#tool nuget:?package=SmartDateRangeParser&version=1.0.0
                    
Install as a Cake Tool

๐Ÿ—“๏ธ SmartDateRangeParser

A developer-friendly .NET library for parsing natural human date expressions like "last 3 business days" or "this week" into usable DateTime ranges.

๐Ÿš€ Features

  • Fluent parsing of expressions like:
    • last 7 days
    • this week, last month
    • last 3 business days
    • today, yesterday, tomorrow
  • Returns easy-to-use DateTime Start and DateTime End
  • Small, fast, and dependency-free
  • Perfect for filters, dashboards, reports, and scheduled jobs

๐Ÿ“ฆ Installation

Install from NuGet:

dotnet add package SmartDateRangeParser

๐Ÿ“Œ Example Usage

var range = SmartDateRange.Parse("last 3 business days");

Console.WriteLine(range.Start); // e.g. 2025-06-02
Console.WriteLine(range.End);   // e.g. 2025-06-04

๐Ÿ’ก Supported Expressions

Input Description
today Todayโ€™s date
yesterday Yesterdayโ€™s date
last 5 days Previous 5 calendar days
last 3 business days Skips weekends
this week Monday to today
this month First of month to today

More expressions coming soon!

๐Ÿ› ๏ธ Planned Roadmap

  • Add support for this quarter, next month
  • Fiscal/calendar year support
  • Custom expression registration
  • Localization support (German, French)

๐Ÿ”„ Changelog

See CHANGELOG.md

๐Ÿงช Run Tests

dotnet test

๐Ÿค Contributing

Pull requests welcome! Please see CONTRIBUTING.md for details.

๐Ÿ“„ License

MIT โ€” see LICENSE


โญ If you find this useful, give it a star!

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  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 was computed.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net9.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.4 182 6/15/2025
1.0.3 166 6/15/2025
1.0.2 190 6/15/2025
1.0.0 305 6/9/2025