isweekend

Determine weekend elements

Syntax

tf = isweekend(t)

Description

tf = isweekend(t) returns an array the same size as t containing logical 1 (true) where the corresponding element of t is a datetime that occurs on a weekend day, and logical 0 (false) otherwise. Weekend days are Saturday and Sunday.

Examples

Determine If Date Occurs During Weekend

t = datetime(2014,5,2:5,'Format','eee dd-MMM-yyyy')

t = 1×4 datetime
   Fri 02-May-2014   Sat 03-May-2014   Sun 04-May-2014   Mon 05-May-2014

tf = isweekend(t)

tf = 1×4 logical array

   0   1   1   0

May 3 and May 4, 2014, are days that fall on a weekend.

Input Arguments

t — Input date and time

datetime array

Input date and time, specified as a datetime array.

Extended Capabilities

Tall Arrays

Calculate with arrays that have more rows than fit in memory.

The isweekend function fully supports tall arrays. For more information, see Tall Arrays.

Thread-Based Environment

Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

Distributed Arrays

Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

This function fully supports distributed arrays. For more information, see Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Version History

Introduced in R2014b