helper-dates 0.0.2

jwPro Date Helpers

This project contains of number of date related to helper functions and extension methods.

Current primary functions:

• identify special dates or holidays
• business related functions

To use helper functions:

1. Add a reference helper-dates
2. Add the namespace directive:

using jwpro.DateHelper.Enums;
using jwpro.DateHelper.Helpers;

3. Call methods using the SpecialDateHelper static class

To use extension methods:

1. Add a reference helper-dates
2. Add the namespace directive:

using jwpro.DateHelper.Enums;
using jwpro.DateHelper.Extensions;

3. Call extension methods from any DataTime variable

To use Business Date Manager

1. Add a reference helper-dates
2. Add the namespace directive:

using jwpro.DateHelper.Configuration;
using jwpro.DateHelper.Managers;

3. The constructor for BusinessDateManager expects an instance of BusinessDateManagerConfiguration to be injected
4. This can be accomplished by adding at BusinessDateManagerConfiguration section to your appsettings.json file like this:

	"BusinessDateManagerConfiguration": {
		"PaidHolidays": [
			{
				"AssociatedSpecialDate": "Thanksgiving_Day"
			},
			{
				"Name": "Day After Thanksgiving",
				"RelatedSpecialDate": "Thanksgiving_Day",
				"RelatedSpecialDateOffset": 1
			},
			{
				"Name": "New Years Eve",
				"RelatedSpecialDate": "New_Years_Day",
				"RelatedSpecialDateOffset": 365
			},
			{
				"AssociatedSpecialDate": "New_Years_Day"
			}
		]
	}

1. The PaidHoliday class expects either
   1. An AssociatedSpecialDate that matches a value on the SpecialDate enum or
   2. A Name and a RelatedSpecialDate with an appropriate RelatedSpecialDateOffset or
   3. A Name and a DateCalculation

5. The values can BusinessDateManagerConfiguration can be configured to be injected in the BusinessDateManager like this:

  _config = new ConfigurationBuilder().AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
                .Build();
  _businessConfig = new BusinessDateManagerConfiguration();
  _config.GetSection("BusinessDateManagerConfiguration").Bind(_businessConfig);
  _services.AddSingleton<BusinessDateManagerConfiguration>(_businesConfig);

Would love for others to contribute

If you have any questions - drop me a note

Jason Wilson