A key problem when working with dates is the impact of holidays and weekends. To manage this complexity, a holiday calendar is used.
A holiday calendar implementation keeps track of which dates are holidays and which are weekends. Different countries have different holiday dates and thus different calendars. It is not unusual for individual exchanges or other financial entities to have their own calendar.
strata-basics module includes a holiday calendar interface and some common implementations.
The key interface is
HolidayCalendar which defines methods to query the calendar.
The calendar is accessed via an identifier
Each holiday calendar has a unique identifier.
To obtain the identifier from a string, use
The actual holiday calendar can then be obtained from
HolidayCalendarId holCalId = HolidayCalendarId.of("GBLO"); HolidayCalendar holCal = holCalId.resolve(ReferenceData.standard());
ReferenceData provided separation between the identifier and the holiday calendar.
This allows users of Strata to supply their own holiday calendar data.
To aid evaluation, Strata provides some standard holiday calendars.
All available holiday calendars can be listed using the static method
Common holiday calendars can also be obtained using static constants on
HolidayCalendarId holCalId = HolidayCalendarIds.GBLO;
Once a holiday calendar is obtained, various methods are available to query the calendar. Some key methods are shown here, see the Javadoc for more information:
// is the date a holiday/weekend or a business day boolean holiday = holCal.isHoliday(LocalDate); boolean busday = holCal.isBusinessDay(LocalDate); // next/previous business day LocalDate nextDay = holCal.next(LocalDate); LocalDate nextDay = holCal.nextOrSame(LocalDate); LocalDate prevDay = holCal.previous(LocalDate); LocalDate prevDay = holCal.previousOrSame(LocalDate); // last business day of month boolean lastBusDay = holCal.isLastBusinessDayOfMonth(LocalDate); LocalDate lastBusDay = holCal.lastBusinessDayOfMonth(LocalDate); // number of business days int days = holCal.daysBetween(LocalDate, LocalDate)
Note that when querying dates, there is no difference between a holiday and a weekend.
Standard Holiday Calendars
Strata provides a set of standard holiday calendars.
Default Holiday Calendar for a currency
A holiday calendar can also be obtained from a currency:
HolidayCalendarId holCalId = HolidayCalendarId.defaultByCurrency(Currency.USD);
See the default holiday calendar list to find the default for each currency.