week

Week number of input date and time

Syntax

w = week(t)

w = week(t,weekType)

Description

w = week(t) returns the week-of-year numbers of the datetime values in t. The m output is a double array the same size as t and contains integer values from 1 to 53.

w = week(t,weekType) returns the type of week number specified by weekType.

Examples

Find Week of Year Numbers of Dates

t = datetime(2013,05,31):calmonths(3):datetime(2014,06,15)

t = 1x5 datetime
   31-May-2013   31-Aug-2013   30-Nov-2013   28-Feb-2014   31-May-2014

w = week(t)

w = 1×5

    22    35    48     9    22

Input Arguments

t — Input date and time

datetime array

Input date and time, specified as a datetime array.

weekType — Type of week values

'weekofyear' (default) | 'weekofmonth'

Type of week values, specified as either 'weekofyear' or 'weekofmonth'.

• If weekType is 'weekofyear', then week returns the week-of-year number. Week 1 is the week in which January 1 falls, even if fewer than four days of that week fall in the same year.

• If weekType is 'weekofmonth', then week returns the week-of-month number. Week 1 in a month is defined as the week in which the first day of the month falls, even if fewer than four days of that week fall in the same month.

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.

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