https://github.com/joaomatossilva/DateTimeExtensions
This project is a merge of several common DateTime operations on the form of extensions to System.DateTime, including natural date difference text (precise and human rounded), holidays and working days calculations on several culture locales.
https://github.com/joaomatossilva/DateTimeExtensions
datetime good-first-issue
Last synced: about 1 month ago
JSON representation
This project is a merge of several common DateTime operations on the form of extensions to System.DateTime, including natural date difference text (precise and human rounded), holidays and working days calculations on several culture locales.
- Host: GitHub
- URL: https://github.com/joaomatossilva/DateTimeExtensions
- Owner: joaomatossilva
- License: other
- Created: 2011-08-22T09:17:24.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2024-10-29T09:12:52.000Z (6 months ago)
- Last Synced: 2024-10-29T11:02:04.872Z (6 months ago)
- Topics: datetime, good-first-issue
- Language: C#
- Homepage: http://datetimeextensions.azurewebsites.net/
- Size: 22.5 MB
- Stars: 770
- Watchers: 45
- Forks: 344
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-csharp - DateTimeExtensions - Common Date Time operations on the form of extensions to `System.DateTime`, including holidays and working days calculations on several culture locales. (Datetime)
- awesome-dotnet-cn - DateTimeExtensions - `System.DateTime`通用日期时间扩展形式，包括多种文化中的假日与工作日计算。 (日期)
- awesome - joaomatossilva/DateTimeExtensions - This project is a merge of several common DateTime operations on the form of extensions to System.DateTime, including natural date difference text (precise and human rounded), holidays and working days calculations on several culture locales. (C\#)
- awesome-dotnet - DateTimeExtensions - Common Date Time operations on the form of extensions to `System.DateTime`, including holidays and working days calculations on several culture locales. (Datetime)
- awesome-dot-dev - DateTimeExtensions - Common Date Time operations on the form of extensions to `System.DateTime`, including holidays and working days calculations on several culture locales. (Datetime)
- awsome-dotnet - DateTimeExtensions - Common Date Time operations on the form of extensions to `System.DateTime`, including holidays and working days calculations on several culture locales. (Datetime)
- Awesome-Nuget-Packages - **DateTimeExtensions**
- awesome-dotnet - DateTimeExtensions - Common Date Time operations on the form of extensions to `System.DateTime`, including holidays and working days calculations on several culture locales. (Datetime)
README
# DateTimeExtensions
[](https://www.nuget.org/packages/DateTimeExtensions/)
[](https://www.myget.org/feed/datetimeextensions/package/nuget/DateTimeExtensions)
[](https://github.com/joaomatossilva/DateTimeExtensions)
## 📅 What is DateTimeExtensions?
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.
## ✨ Key Features
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.
## 📦 Installation
Install DateTimeExtensions via [NuGet](https://learn.microsoft.com/en-us/nuget/reference/nuget-exe-cli-reference?tabs=windows):
```
Install-Package DateTimeExtensions
```
## 🚀 Quick Start
Here are some examples of what you can do with DateTimeExtensions:
```csharp
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"));
```
## 🌍 Supported Cultures
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!
## 🔧 Advanced Features
### Exporting Holidays
You can export holidays to various calendar formats:
```csharp
var exporter = ExportHolidayFormatLocator.LocateByType(ExportType.OfficeHolidays);
exporter.Export(new WorkingDayCultureInfo("en-US"), 2024, textWriter);
```
### Custom Working Day Definitions
Implement `IWorkingDayCultureInfo` to define custom working day rules for your specific needs.
## 🤝 Contributing
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").
## 📖 Documentation
For more detailed information, visit our [official documentation](http://www.kspace.pt/DateTimeExtensions/).
## 📃 License
This project is licensed under the Apache License. See the [LICENSE](LICENSE.md) file for details.
## ❤️ Acknowledgements
- Logo design by @manuelbarbosa
- Build script assistance by @matkoch using [Nuke](http://www.nuke.build/)
- Open source license provided by [JetBrains](https://www.jetbrains.com/)
---
DateTimeExtensions: Making date and time operations in C# simpler and more intuitive.