calweeks

Calendar duration in weeks

Syntax

W = calweeks(X)

Description

W = calweeks(X) returns an array representing calendar weeks equivalent to the values in X.

• If X is a numeric array, then W is a calendarDuration array with each element equal to the number of calendar weeks in the corresponding element of X.

• If X is a calendarDuration array, then calweeks returns the number of whole weeks equivalent to each calendar duration in X.

Examples

Create Array of Calendar Weeks

X = magic(4);
W = calweeks(X)

W = 4x4 calendarDuration
   16w    2w    3w   13w
    5w   11w   10w    8w
    9w    7w    6w   12w
    4w   14w   15w    1w

Convert Calendar Durations to Calendar Weeks

Create an array of calendar durations. Then, convert each value to the equivalent number of whole calendar weeks.

X = caldays(15:17) + hours(1.2345)

X = 1x3 calendarDuration
   15d 1h 14m 4.2s   16d 1h 14m 4.2s   17d 1h 14m 4.2s

W = calweeks(X)

W = 1×3

     2     2     2

Input Arguments

X — Input array

numeric array | calendar duration array | logical array

Input array, specified as a numeric array, calendar duration array, or logical array. If X is a numeric array, it must contain only integer values. That is, you cannot create fractional calendar units.

Output Arguments

W — Calendar weeks

scalar | vector | matrix | multidimensional array

Calendar weeks, returned as a scalar, vector, matrix, or multidimensional array. W is the same size as X. The data type of W depends on X.

• If X is a numeric array, then W is an array of calendar durations in units of equivalent flexible-length calendar weeks.

• If X is a calendarDuration array, then W is a double array of integer values representing whole calendar weeks.

Extended Capabilities

Tall Arrays

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

This 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.

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