days252bus

Number of business days between dates

Syntax

NumberDays = days252bus(StartDate,EndDate)

NumberDays = days252bus(___HolidayVector)

Description

NumberDays = days252bus(StartDate,EndDate) computes the number of business days (that is, non-holiday or non-weekend) between the two input dates.

NumberDays = days252bus(___HolidayVector) adds an optional argument for HolidayVector. If a holiday vector is not optionally specified, then the holidays.m file is used to determine the holidays.

Examples

Computes the Number of Business Days Between Two Input Dates

This example shows how to compute the number of business days (i.e. non-holiday or non-weekend) between two dates using the days252bus convention.

NumberDays = days252bus(datetime(2009,1,1), datetime(2009,8,1))

NumberDays = 
146

Input Arguments

StartDate — Start date

datetime array | string array | date character vector

Start date, specified as a scalar or an N-by-1 or 1-by-N vector using a datetime array, string array, or date character vectors.

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

Data Types: double | char | string | datetime

EndDate — End date

datetime array | string array | date character vector

End date, specified as a scalar or an N-by-1 or 1-by-N vector using a datetime array, string array, or date character vectors.

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

Data Types: char | string | datetime

HolidayVector — Holidays

holidays.m (default) | datetime array | string array | date character vector | serial date number

Holidays, specified as a scalar or an N-by-1 or 1-by-N vector using a datetime array, string array, or date character vectors.

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

Data Types: char | string | datetime

Output Arguments

NumberDays — Number of days between two dates

vector

Number of days between two dates, returned as a scalar or an N-by-1 or 1-by-N vector containing the number of days.

Version History

Introduced before R2006a

R2022b: Serial date numbers not recommended

Although days252bus 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.