holidays

Holidays and nontrading days

Syntax

H = holidays

H = holidays(StartDate,EndDate)

H = holidays(___,AltHolidays)

Description

H = holidays returns a vector or datetime array corresponding to all holidays and nontrading days.

H = holidays(StartDate,EndDate) returns a vector or datetime array corresponding to the holidays and nontrading days between StartDate and EndDate, inclusive.

H = holidays(___,AltHolidays) returns a vector or datetime array corresponding to the alternate list of holidays and nontrading days.

Examples

Determine Holidays for a Given StartDate and EndDate

Create a vector of serial date numbers corresponding to all holidays and nontrading dates between a specified StartDate and EndDate:

H = holidays('jan 1 2001', 'jun 23 2001') 

H = 5×1

      730852
      730866
      730901
      730954
      730999

datestr(H)

ans = 5x11 char array
    '01-Jan-2001'
    '15-Jan-2001'
    '19-Feb-2001'
    '13-Apr-2001'
    '28-May-2001'

Alternatively, using a datetime array for StartDate and EndDate returns a datetime array for H.

H = holidays(datetime('1-Jan-2001','Locale','en_US'),...
datetime('23-Jun-2001','Locale','en_US'))

H = 5x1 datetime
   01-Jan-2001
   15-Jan-2001
   19-Feb-2001
   13-Apr-2001
   28-May-2001

Input Arguments

StartDate — Start date

serial date number | date character vector | datetime object

Start date, specified using a serial date number, date character vector, or datetime array.

Data Types: double | char | datetime

EndDate — End date

serial date number | date character vector | datetime object

End date, specified using a serial date number, date character vector, or datetime array.

Data Types: double | char | datetime

AltHolidays — Alternate list of holidays and nontrading days

serial date number | date character vector | datetime object

Alternate list of holidays and nontrading days, specified using a serial date number, date character vector, or datetime array.

Data Types: double | char | datetime

Output Arguments

H — Dates corresponding to all holidays and nontrading days

vector | datetime

Dates corresponding to all holidays and nontrading days, returned as a vector or a datetime array of dates.

Note

If StartDate, EndDate, and AltHolidays are all either serial date numbers or date character vectors, H is returned as serial date numbers. If either StartDate, EndDate, or AltHolidays are datetime arrays, H is returned as a datetime array.

More About

holidays

The holidays function is based on a modern five-day workweek.

This function contains all holidays and special nontrading days for the New York Stock Exchange from January 1, 1885 to December 31, 2070.

Since the New York Stock Exchange was open on Saturdays before September 29, 1952, exact closures from 1885 to 2070 include Saturday trading days. To capture these dates, use the function nyseclosures. The results from holidays and nyseclosures are identical if the WorkWeekFormat in nyseclosures is 'Modern'.