calweeks

Calendar duration in weeks

collapse all in page

Syntax

W = calweeks(X)

Description

example

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

collapse all

Create Array of Calendar Weeks

Open Live Script

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

Open Live Script

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

collapse all

`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

collapse all

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