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 = ['15-feb-2001'; '16-feb-2001'; '17-feb-2001'];
Busday = isbusday(datetime(Date,'Locale','en_US'))

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('June 21, 2003', [], 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

serial date number | date character vector | datetime array

Date being checked, specified as a serial date number, date character vector, or datetime array. 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.

Data Types: double | char | datetime

Holiday — Holidays and nontrading-day dates

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

Holidays and nontrading-day dates, specified as vector.

All dates in Holiday must be the same format: either serial date numbers, or date character vectors, or datetime arrays. (Using serial date numbers improves performance.) The holidays function supplies the default vector.

Data Types: double | char | 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