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 = 5×11 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(2001,1,1),datetime(2001,6,23))

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

Input Arguments

StartDate — Start date

datetime array | string array | date character vector

Start date, specified using a scalar or vector using a datetime array, string array, or date character vectors.

To support existing code, holidays also accepts serial date numbers as inputs, but they are not recommended.

Data Types: char | string | datetime

EndDate — End date

datetime array | string array | date character vector

End date, specified scalar or vector using a datetime array, string array, or date character vectors.

To support existing code, holidays also accepts serial date numbers as inputs, but they are not recommended.

Data Types: char | string | datetime

AltHolidays — Alternate list of holidays and nontrading days

datetime array | string array | date character vector

Alternate list of holidays and nontrading days, specified scalar or vector using a datetime array, string array, or date character vectors.

To support existing code, holidays also accepts serial date numbers as inputs, but they are not recommended.

Data Types: char | string | 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 strings or date character vectors, H is returned as serial date numbers. Use the function datetime to convert serial date numbers to formatted datetime arrays. 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'.

Version History

Introduced before R2006a

R2022b: Serial date numbers not recommended

Although holidays supports serial date numbers, datetime values are recommended instead. The datetime data type provides flexible date and time formats, storage out to nanosecond precision, and properties to account for time zones and daylight saving time.

To convert serial date numbers or text to datetime values, use the datetime function. For example:

t = datetime(738427.656845093,"ConvertFrom","datenum");
y = year(t)

y =

        2021

There are no plans to remove support for serial date number inputs.