DateTimeToolkit 1.0.1
See the version list below for details.
dotnet add package DateTimeToolkit --version 1.0.1
NuGet\Install-Package DateTimeToolkit -Version 1.0.1
<PackageReference Include="DateTimeToolkit" Version="1.0.1" />
paket add DateTimeToolkit --version 1.0.1
#r "nuget: DateTimeToolkit, 1.0.1"
// Install DateTimeToolkit as a Cake Addin #addin nuget:?package=DateTimeToolkit&version=1.0.1 // Install DateTimeToolkit as a Cake Tool #tool nuget:?package=DateTimeToolkit&version=1.0.1
DateTimeToolkit
Comprehensive DateTime utilities for developers.
Overview
The DateTime Extension Library provides a comprehensive set of approximately 100 extension methods for the DateTime structure, enhancing its functionality for a wide range of date and time operations. This library includes methods for calculating the start and end of different date ranges (days, weeks, months, years), rounding dates to the nearest interval, checking if dates fall within specific ranges, generating lists of dates, and much more.
Installation
This project is available as a NuGet package.
PM> Install-Package DateTimeToolkit
Features
- Start and End of Date Ranges: Methods to get the start and end of days, weeks, months, and years.
- Rounding: Methods to round dates to the nearest specified interval.
- Range Checking: Methods to check if a date falls within a specified range.
- Date Generation: Methods to generate lists of dates within a specific range.
- Occurrences: Methods to get occurrences between two dates according to a specified interval.
- Week Number Calculation: Methods to calculate the week number of a year for a given date.
- Custom Week Start: Methods to get the start and end of weeks with a customizable start day.
Usage Examples
Here are some usage examples for the extension methods provided in this library:
- Start and End of Date Ranges
DateTime now = new DateTime(2023, 6, 1, 15, 30, 0);
// Get the start and end of the day
DateTime startOfDay = DateTimeRangeExtension.GetStartOfDay(now);
DateTime endOfDay = DateTimeRangeExtension.GetEndOfDay(now);
// Output: startOfDay = 2023-06-01 00:00:00
// Output: endOfDay = 2023-06-01 23:59:59.9999999
// Get the start and end of the month
DateTime startOfMonth = DateTimeRangeExtension.GetStartOfMonth(now);
DateTime endOfMonth = DateTimeRangeExtension.GetEndOfMonth(now);
// Output: startOfMonth = 2023-06-01 00:00:00
// Output: endOfMonth = 2023-06-30 00:00:00
// Get the start and end of the year
DateTime startOfYear = DateTimeRangeExtension.GetStartOfYear(now);
DateTime endOfYear = DateTimeRangeExtension.GetEndOfYear(now);
// Output: startOfYear = 2023-01-01 00:00:00
// Output: endOfYear = 2023-12-31 00:00:00
// Get the start and end of the week (assuming week starts on Monday)
DateTime startOfWeek = DateTimeRangeExtension.GetStartOfWeek(now, DayOfWeek.Monday);
DateTime endOfWeek = DateTimeRangeExtension.GetEndOfWeek(now, DayOfWeek.Monday);
// Output: startOfWeek = 2023-05-29 00:00:00
// Output: endOfWeek = 2023-06-04 00:00:00
- Rounding Dates
DateTime dateTime = new DateTime(2023, 12, 24, 10, 35, 0);
TimeSpan interval = new TimeSpan(0, 30, 0);
bool roundUp = false;
// Round to nearest interval (e.g., 30 minutes)
DateTime rounded = DateTimeCalculationExtension.RoundToNearestInterval(dateTime, interval, roundUp);
// Output: rounded = 2023-12-24 10:30:00
- Range Checking
DateTime date = new DateTime(2023, 12, 24);
DateTime startDate = new DateTime(2023, 12, 20);
DateTime endDate = new DateTime(2023, 12, 31);
// Check if date falls within the range
bool isInRange = DateTimeRangeExtension.IsDateInRange(date, startDate, endDate);
// Output: isInRange = true
- Date Generation
DateTime startDate = new DateTime(2023, 12, 20);
DateTime endDate = new DateTime(2023, 12, 24);
// Generate a list of dates within the specified range
List<DateTime> datesInRange = DateTimeRangeExtension.GetDatesInRange(startDate, endDate);
// Output: datesInRange = [2023-12-20 00:00:00, 2023-12-21 00:00:00, 2023-12-22 00:00:00, 2023-12-23 00:00:00, 2023-12-24 00:00:00]
- Occurrences
DateTime start = new DateTime(2023, 6, 1);
DateTime end = new DateTime(2023, 6, 5);
TimeSpan interval = new TimeSpan(1, 0, 0, 0);
// Get occurrences between the start and end dates
List<DateTime> occurrences = DateTimeRangeExtension.GetOccurrences(start, end, interval);
// Output: occurrences = [2023-06-01 00:00:00, 2023-06-02 00:00:00, 2023-06-03 00:00:00, 2023-06-04 00:00:00, 2023-06-05 00:00:00]
- Week Number Calculation
DateTime dateTime = new DateTime(2023, 12, 24);
CultureInfo culture = new CultureInfo("en-US");
// Get the week number of the year for the specified date
int weekNumber = DateTimeCalculationExtension.GetWeekOfYear(dateTime, culture);
// Output: weekNumber = 52
See Unit Tests in the project for more details and examples of all extensions.
Contributing
Contributions are welcome! Please fork this repository and submit a pull request for any features, bug fixes, or improvements.
License
This project is licensed under the MIT License - see the LICENSE file for details.
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. |
.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.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.