WOLFRAM

Wolfram Language & System Documentation Center

HolidayCalendar

is an option that specifies the holiday calendar schedule in business day functions.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Applications  
See Also
Related Guides
History
Cite this Page

HolidayCalendar

HolidayCalendar

is an option that specifies the holiday calendar schedule in business day functions.

Details

  • HolidayCalendar is {"UnitedStates","Default"} by default.
  • HolidayCalendar can be set to either one of the prebuilt calendars contained in the CalendarData paclet, or to a custom calendar by specifying a set of holiday schedules.
  • The basic unit of a holiday schedule is a holiday criterion, a three-element list of tests in the form of pure functions that are to be applied to the year, month, and day of a given calendar, respectively. A date is a holiday if all three tests return true when applied to it.
  • A separate set of tests must be specified for each calendar system in which holidays are celebrated.
  • Available calendar systems are:
  • "Gregorian"Gregorian solar calendar
    "Julian"Julian solar calendar
    "Jewish"Jewish lunisolar calendar
    "Islamic"Islamic lunar calendar (based on Mecca lunations)

Examples

open all close all

Basic Examples  (2)

Specify a prebuilt holiday schedule other than the default:

Wolfram Language code: DayRange[DateObject[{2000, 1, 6}, "Day", "Gregorian", -6.], DateObject[{2003, 7, 6}, "Day", "Gregorian", -6.], "Holiday", HolidayCalendar -> Entity["Country", "Turkey"]]

Specify a prebuilt holiday schedule other than the default:

Wolfram Language code: DayRange[DateObject[{2000, 1, 6}, "Day", "Gregorian", -6.], DateObject[{2003, 7, 6}, "Day", "Gregorian", -6.], "Holiday", HolidayCalendar -> {Entity["Country", "Singapore"], "Default"}]

Scope  (5)

Specify a holiday calendar as a string:

Wolfram Language code: DayRange[DateObject[{2026, 1, 1}], DateObject[{2026, 12, 31}], "Holiday", HolidayCalendar -> "Japan"]

Specify a holiday calendar as an entity:

Wolfram Language code: DayRange[DateObject[{2026, 1, 1}], DateObject[{2026, 12, 31}], "Holiday", HolidayCalendar -> Entity["Country", "Finland"]]

Specify the holiday calendar to use with business days:

Wolfram Language code: TimeSeries[Range[4], {DateObject[{2025, 7, 1}], Automatic, "BusinessDay"}, HolidayCalendar -> "UnitedStates"]
Wolfram Language code: Normal[%]

The fourth of July is not a holiday in Mexico:

Wolfram Language code: TimeSeries[Range[4], {DateObject[{2025, 7, 1}], Automatic, "BusinessDay"}, HolidayCalendar -> "Mexico"]
Wolfram Language code: Normal[%]

Federal business days may be different from those of a stock exchange:

Wolfram Language code: DayRange[DateObject[{2026, 4, 1}], DateObject[{2026, 4, 7}], "BusinessDay", HolidayCalendar -> "UnitedStates"]
Wolfram Language code: DayRange[DateObject[{2026, 4, 1}], DateObject[{2026, 4, 7}], "BusinessDay", HolidayCalendar -> {"UnitedStates", "NYSE"}]

Define a custom schedule:

Wolfram Language code: DayRange[DateObject[{2000, 1, 6}, "Day", "Gregorian", -6.], DateObject[{2018, 7, 6}, "Day", "Gregorian", -6.], "Holiday", HolidayCalendar -> {"Gregorian" -> {{True&, # == 5&, # == 9&}}}]

Applications  (1)

Use HolidayCalendar as an option for TimeSeries to visualize business days in a given country:

Wolfram Language code: ts = TimeSeries[ConstantArray[1, 40], {{2014, 11, 1}, Automatic, "BusinessDay"}, HolidayCalendar -> "UnitedStates"]
Wolfram Language code: DateListPlot[ts, Joined -> False, Filling -> Axis, FrameTicks -> {{Automatic, Automatic}, {DateRange[ts["FirstTime"], ts["LastTime"], {2, "Day"}], None}}, DateTicksFormat -> "DayShort"]
Wolfram Research (2012), HolidayCalendar, Wolfram Language function, https://reference.wolfram.com/language/ref/HolidayCalendar.html.

Text

Wolfram Research (2012), HolidayCalendar, Wolfram Language function, https://reference.wolfram.com/language/ref/HolidayCalendar.html.

CMS

Wolfram Language. 2012. "HolidayCalendar." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/HolidayCalendar.html.

APA

Wolfram Language. (2012). HolidayCalendar. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/HolidayCalendar.html

BibTeX

@misc{reference.wolfram_2026_holidaycalendar, author="Wolfram Research", title="{HolidayCalendar}", year="2012", howpublished="\url{https://reference.wolfram.com/language/ref/HolidayCalendar.html}", note=[Accessed: 12-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_holidaycalendar, organization={Wolfram Research}, title={HolidayCalendar}, year={2012}, url={https://reference.wolfram.com/language/ref/HolidayCalendar.html}, note=[Accessed: 12-June-2026]}