PublicHoliday 3.1.0

Public Holidays

Nuget: Install-Package PublicHoliday

Orders and deliveries, data transfers, and other processes can often only be made on business working days. They cannot be made on national public holidays. Public holidays in many countries can be calculated algorithmically.

//get a list of all holidays for 2017
IList<DateTime> result = new USAPublicHoliday().PublicHolidays(2017);

//get the next working day
DateTime dayAfterColumbus = new USAPublicHoliday().NextWorkingDay(new DateTime(2006, 10, 8)); //returns 10 October 2006

//2nd January 2006 is a Monday. But because 1st January was a Sunday, the bank holiday is the next Monday
bool isHoliday = new UKBankHoliday().IsBankHoliday(new DateTime(2006, 1, 2)); //returns true

//what's the next working day after Sunday 24th December 2006?
DateTime nextWorkingDay = new UKBankHoliday().NextWorkingDay(new DateTime(2006, 12, 24)); //returns 27 December 2006

The library contains adjustments for one-off holidays.

//Next working day after royal wedding - next working day is Tuesday 3rd May (Monday 2nd is MayDay)
DateTime nextWorkingDayAfterRoyalWedding = new UKBankHoliday().NextWorkingDay(new DateTime(2011, 4, 29));

There are libraries for:

• Europe
  • Austria : AustriaPublicHoliday
  • Belgium : BelgiumPublicHoliday
  • Czech Republic : CzechRepublicPublicHoliday
  • ECB : EcbTargetClosingDay (European Central Bank SEPA Target Closing days - no exchange rates and no SEPA transactions)
  • Denmark : DenmarkPublicHoliday
  • Estonia : EstoniaPublicHoliday
  • Finland: FinlandPublicHoliday
  • France : FrancePublicHoliday
  • Germany : GermanPublicHoliday (set State property for regional holidays)
  • Greece : GreecePublicHoliday
  • Ireland : IrelandPublicHoliday
  • Italy : ItalyPublicHoliday
  • Lithuania : LithuaniaPublicHoliday
  • Luxembourg : LuxembourgPublicHoliday
  • Montenegro : MontenegroPublicHoliday
  • Netherlands : DutchPublicHoliday
  • Norway : NorwayPublicHoliday
  • Poland : PolandPublicHoliday
  • Portugal : PortugalPublicHoliday ()
  • Romania : RomanianPublicHoliday
  • Serbia : SerbianPublicHoliday
  • Slovakia : SlovakiaPublicHoliday
  • Spain : SpainPublicHoliday
  • Slovenia : SloveniaPublicHoliday
  • Sweden : SwedenPublicHoliday
  • Switzerland: SwitzerlandPublicHoliday
  • UK : UKBankHoliday (set UkCountry property for Scotland/Northern Ireland variations)
• 5. Europe/Asia
  • Kazakhstan : KazakhstanPublicHoliday
  • Turkey : TurkeyPublicHoliday
• N America
  • Canada : CanadaPublicHoliday (set Province in constructor for regional holidays)
  • Canada : CanadaQuebecGovClosingDay (Government province of Quebec closing day)
  • USA : USAPublicHoliday
  • USA : USAFederalReserveHoliday
  • USA : USANewYorkStockExchangeHoliday
• S America
  • Brazil : BrazilPublicHoliday
• Oceania
  • Australia : AustraliaPublicHoliday (set State property for regional holidays, see note below)
  • New Zealand : NewZealandPublicHoliday
• Asia
  • Japan : JapanPublicHoliday

All use the common interface IPublicHoliday containing:

• IsPublicHoliday(DateTime) (UK: also IsBankHoliday(DateTime))
• IsWorkingDay(DateTime) (i.e. not public holiday, Saturday or Sunday)
• NextWorkingDay(DateTime)
• NextWorkingDay(DateTime, int)
• NextWorkingDayNotSameDay(DateTime)
• NextWorkingDayNotSameDay(DateTime, int)
• PreviousWorkingDay(DateTime)
• PreviousWorkingDay(DateTime, int)
• PreviousWorkingDayNotSameDay(DateTime)
• PreviousWorkingDayNotSameDay(DateTime, int)
• PublicHolidays(int year)
• PublicHolidaysInformation(int year)
• PublicHolidayNames(int year)
• GetHolidaysInDateRange(DateTime, DateTime)
• UseCachingHolidays
• BusinessDaysAdd(DateTime, int)
  • if you have an <abbr title="servive level agreement">SLA</abbr>/turn-around time of 3 business days, calendar.BusinessDaysAdd(dt, 3) will give you the end-date 3 business days (Mon-Fri excluding public holidays)
• BusinessDaysBetween(DateTime, DateTime) (number of Mon-Fri working days)

There are also static methods for all statutory holidays.

Weekend Rules

For many countries, when holidays fall on a weekend, the next working Monday becomes a public holiday (this is sometimes called "Mondayised"). This is the general rule in the UK, and used for certain (but not all) holidays in Australia and New Zealand.

In the USA, when holidays fall on Sundays, the holiday is moved to Monday. When the holiday falls on Saturday, the holiday is moved to the preceding Friday. The USA Federal Reserve holidays differ slightly, as holidays that fall on a Saturday do not cause a closure on the preceding Friday as described on the Federal Reserve's website.

For most of Europe, there is no standard rule for when the holidays fall on weekends. Normally these days are just added to the annual leave.

Variations by states and province

In Canada there are some provincial holidays that vary by region. You can access these by passing in the ISO Code of the province to the constructor

//Retrieve a list of holidays in Saskatchewan for 2016
IList<DateTime> result = new CanadaPublicHoliday("SK").PublicHolidays(2016);

In France the calendar comes with holidays valid in all the country.

// Get the list of public holidays for 2024
IList<DateTime> result = new FrancePublicHoliday().PublicHolidays(2024);

// Get the list of public holidays name for 2024
IList<DateTime> result = new FrancePublicHoliday().PublicHolidayNames(2024);

// Get the list of public holidays name and date for 2024
IDictionary<DateTime, string> result = new FrancePublicHoliday().PublicHolidayNames(2024);

A method returns a list of objects for all public holidays, with the names of the regions concerned for each date :

var calendar = new FrancePublicHoliday { Region = FrancePublicHoliday.Regions.Martinique };
// Get the 14 dates for the public holidays in Martinique for 2024
var hols = calendar.PublicHolidays(2024);

// We can also recover all the public holidays of all the regions combined
var calendar = new FrancePublicHoliday { };
IDictionary<DateTime, string> hols = calendar.PublicHolidays(2024);

In Germany specify the state using an enum (the ISO code)

//Calendar for Saxony
var calendar = new GermanPublicHoliday { State = GermanPublicHoliday.States.SN };
IList<DateTime> result = calendar.PublicHolidays(2017);
//result contains 22 November 2017, Repentance and Prayer Day

In United Kingdom England/Wales is default. Specify Scotland or Northern Ireland using an enum

//Calendar for Scotland
var calendar = new UKBankHoliday { UkCountry = UKBankHoliday.UkCountries.Scotland };
IList<DateTime> result = calendar.PublicHolidays(2022);
//result contains 30 November 2022, St Andrew's Day

In Switzerland the calendar comes with holidays valid in all the country. Add further ones depending on your local rules in the constructor. Choices: hasSecondJanuary, hasLaborDay, hasCorpusChristi, hasChristmasEve, hasNewYearsEve.

var calendar =  var holidayCalendar = new SwitzerlandPublicHoliday { Canton = SwitzerlandPublicHoliday.Cantons.OW };
var nationalDay = new DateTime(2024, 8, 1);
//yes it is
var isHoliday = calendar.IsPublicHoliday(nationalDay);

// We can also recover all the public holidays of all the cantons combined
var holidayCalendar = new SwitzerlandPublicHoliday { Canton = SwitzerlandPublicHoliday.Cantons.ALL };
IDictionary<DateTime, string> hols = holidayCalendar.PublicHolidays(2024);

A method returns a list of objects for all public holidays, with the names of the regions concerned for each date :

var holidayCalendar = new SwitzerlandPublicHoliday();
IList<Holiday> hols = holidayCalendar.PublicHolidaysComplete(2024);

In Australia most holidays are defined by the state or territory. Specify the state using an enum (the ISO code).

//Calendar for Western Australia
var calendar = AustraliaPublicHoliday { State = AustraliaPublicHoliday.States.WA };
var westernAustrliaDay = new DateTime(2017, 6, 5);
//yes it is
var isHoliday = holidayCalendar.IsPublicHoliday(westernAustrliaDay);

IMPORTANT A few Australia state holidays do not have fixed rules, and cannot be calculated.

• For Victoria, AFL Grand Final Day
• For Western Australia, Queen's Birthday (we assume end September BUT may change)
• The calendar does not contain local holidays (Royal Queensland Show day, Royal Hobart Regatta)

Thanks

@petergaal @msmells @oliver-h @DanielSundberg @kant2002 @zanemcca @jcdekoning @thelious @rickbeerendonk @skipishere @MilkyWare @Hrothval @mihaigliga21

License

License is MIT. You are free to use this software in commercial projects.

Building the Source

• If you use Visual Studio 2022 open PublicHoliday.sln (.net 6 +, including .net 8 or 9)
  • You cannot use the command line "dotnet build" because Core tooling cannot build v3.5 (see https://github.com/Microsoft/msbuild/issues/1333)