isbusday

True for dates that are business days

Syntax

Busday = isbusday(Date)

Busday = isbusday(___,Holiday,Weekend)

Description

Busday = isbusday(Date) returns logical true (1) if Date is a business day and logical false (0) otherwise.

Busday = isbusday(___,Holiday,Weekend), using optional input arguments, returns logical true (1) if Date is a business day, and logical false (0) otherwise.

Examples

Determine If a Given Date Is a Business Day

Determine if Date is a business day.

Busday = isbusday('16 jun 2001')

Busday = logical
   0

Determine if a Date vector are business days.

Date = ['15 feb 2001'; '16 feb 2001'; '17 feb 2001'];
Busday = isbusday(Date)

Busday = 3x1 logical array

   1
   1
   0

Determine if a Date vector are business days using a datetime array.

Date = [datetime(2001,2,15); datetime(2001,2,16) ; datetime(2001,2,17)];
Busday = isbusday(Date)

Busday = 3x1 logical array

   1
   1
   0

Set June 21, 2003 (a Saturday) as a business day.

Weekend = [1 0 0 0 0 0 0];
isbusday(datetime(2003,6,21), [], Weekend)

ans = logical
   1

If the second argument, Holiday, is empty ([ ]), the default Holidays vector (generated with holidays and then associated to the NYSE calendar) is used.

Input Arguments

Date — Date being checked

datetime array | string array | date character vector

Date being checked, specified as a scalar or a vector using a datetime array, string array, or date character vectors. Date can contain multiple dates, but they must all be in the same format. Dates are assumed to be whole date numbers or date stamps with no fractional or time values.

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

Data Types: char | string | datetime

Holiday — Holidays and nontrading-day dates

non-trading day vector is determined by the routine holidays (default) | datetime array | string array | date character vector

Holidays and nontrading-day dates, specified as a vector using a datetime array, string array, or date character vectors.

All dates in Holiday must be the same format: either datetimes, strings, date character vectors, or serial date numbers. The holidays function supplies the default vector.

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

Data Types: char | string | datetime

Weekend — Weekend days

[1 0 0 0 0 0 1] (Saturday and Sunday form the weekend) (default) | vector of length 7, containing 0 and 1, where 1 indicates weekend days

Weekend days, specified as a vector of length 7, containing 0 and 1, where 1 indicates weekend days and the first element of this vector corresponds to Sunday.

Data Types: double

Output Arguments

Busday — Logical true if a business day

logical 0 or 1

Logical true if a business day, returned as a logical true (1) if Date is a business day and logical false (0) otherwise.

Version History

Introduced before R2006a

R2022b: Serial date numbers not recommended

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