Module org.holiday.calendar.core

Package org.holiday.calendar

package org.holiday.calendar

Base classes and interfaces of the Holiday Calendar API.

Holiday is a sealed interface describing a single holiday's identity and date-calculation method, with four permitted subtypes: FixedHoliday (same MonthDay every year), FloatingHoliday (date computed via an Observance), SpecialAnniversary (anniversary of a fixed date), and EarlyCloseHoliday (a non-rollable partial trading day, carrying a local close time and zone). HolidayCalendar is a named, immutable collection of holidays, plus a DateRoll weekend-adjustment strategy, that calculates the observed HolidayDates for a given year.

HolidayCalendarService is the extension point implemented by each regional module and discovered at runtime by HolidayCalendarFactory via ServiceLoader:

 HolidayCalendarFactory factory = new HolidayCalendarFactory();
 HolidayCalendar calendar = factory.create("XNYS");

 List<HolidayDate> fullClosures = calendar.calculate(2026);
 if (calendar.hasEarlyCloses()) {
     List<HolidayDate> earlyCloses = calendar.calculateEarlyCloses(2026);
 }
 

Author:

Dave Joyce

Related Packages

Package	Description
org.holiday.calendar.function	Functional interfaces to support construction of filters and date calculation algorithms as lambda expressions.
org.holiday.calendar.observance	Base classes for Observance implementations, used throughout the regional calendar modules.
org.holiday.calendar.util	Shared runtime utilities used by Observance implementations across the regional calendar modules.

Class	Description
AbstractHolidayCalendarService	Abstract base class for HolidayCalendarService implementations, providing the identity behavior common to all concrete service classes.
EarlyCloseHoliday	A holiday which represents a partial trading day — a day on which a market or exchange closes early rather than closing for the entire day.
FixedHoliday	A holiday which occurs on the same date every year.
FloatingHoliday	A holiday which occurs on a different date every year.
Holiday	An official day on which work does not occur.
Holiday.HolidayBuilder	Builder for configurable construction of Holiday objects.
Holiday.Type	Enumerated type of Holiday.
HolidayCalendar	A named collection of holidays observed within a single calendar year.
HolidayCalendar.HolidayCalendarBuilder
HolidayCalendarFactory	Factory for creation of HolidayCalendar objects.
HolidayCalendarNotFoundException	Exception thrown when a requested holiday calendar code is not provided by any registered HolidayCalendarService.
HolidayCalendarService	Required behavior of a service which provides the HolidayCalendar object assigned to a unique code identifier.
HolidayDate	The observed date of a Holiday in a particular year of the Common Era (CE).
SpecialAnniversary	A holiday which commemorates a particular anniversary of an event.