DateTimeExtensions is a powerful C# library that extends the functionality of System.DateTime and System.DateTimeOffset. It provides useful methods for working with dates and times, making your code more expressive and easier to read.

1. Working Days Calculations: Easily add or subtract working days, considering regional holidays.
2. Holiday Support: Includes holiday definitions for multiple cultures and regions.
3. Natural Language Date Differences: Get the difference between dates in human-readable format.
4. Time of Day Operations: Simplify time-based comparisons and checks.
5. Calendar Export: Export holidays to common calendar formats.
6. SourceLink Support: Enables debugging into the source code.

Install DateTimeExtensions via NuGet:

Install-Package DateTimeExtensions

Here are some examples of what you can do with DateTimeExtensions:

using DateTimeExtensions;
// Add 5 working days to a date
DateTime futureDate = DateTime.Now.AddWorkingDays(5);
// Check if a date is a working day
bool isWorkingDay = DateTime.Now.IsWorkingDay();
// Get the difference between dates in natural language
string dateDiff = DateTime.Now.ToNaturalText(DateTime.Now.AddDays(45));
// Check if a time is between two other times
bool isBetween = DateTime.Now.IsBetween(new Time("09:00"), new Time("17:00"));

DateTimeExtensions supports working day and holiday calculations for many cultures, including:

• United States (en-US)
• United Kingdom (en-GB)
• France (fr-FR)
• Germany (de-DE)
• Spain (es-ES)
• Brazil (pt-BR)
• Portugal (pt-PT)
• and many more!

Don't see your culture? Contributions are welcome!

You can export holidays to various calendar formats:

var exporter = ExportHolidayFormatLocator.LocateByType(ExportType.OfficeHolidays);
exporter.Export(new WorkingDayCultureInfo("en-US"), 2024, textWriter);

Implement IWorkingDayCultureInfo to define custom working day rules for your specific needs.

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create a feature branch
3. Implement your feature or bug fix
4. Add or update tests as necessary
5. Submit a pull request

To add new holiday definitions, please prefix culture-specific holidays with the country name (e.g., "USA_IndependenceDay").

For more detailed information, visit our official documentation.

This project is licensed under the Apache License. See the LICENSE file for details.

• Logo design by @manuelbarbosa
• Build script assistance by @matkoch using Nuke
• Open source license provided by JetBrains

DateTimeExtensions: Making date and time operations in C# simpler and more intuitive.