Learn more about Financial Toolbox

weeknum - Week in a year

Syntax

[N]= weeknum(D) [N] = weeknum(D,W)

Arguments

D

Serial date number or a date string.

W

(Optional) A numeric representation of the day a week begins. The week start values and their corresponding day are:

1 (default) — Sunday
2 — Monday
3 — Tuesday
4 — Wednesday
5 — Thursday
6 — Friday
7 — Staurday

Description

[N]= weeknum(D) returns the week of the year given D, a serial date number or a date string.

[N] = weeknum(D,W) returns the week of the year given D, a serial date number or a date string, and W, a numeric representation of the day a week begins.

The weeknum function considers the week containing January 1 to be the first week of the year.

Examples

You can determine the week of the year using a serial date number

N = weeknum(728647)

N =

    52

or a date string

N = weeknum('19-Dec-1994')
N =

    52

The first week of the year must have at least 4 days in it. For example, January 8, 2004 was a Thursday.

weeknum('08-jan-2004')
ans =

     2

You can use weeknum with datenum:

weeknum(datenum('01-Jan-2004'):datenum('08-Jan-2004'))

ans =

     1     1     1     2     2     2     2     2

The default start day of the week is Sunday. Every day after, and including the first Sunday of the year (04-Jan-2004), returns 2 denoting the second week. In this case, the first of week of the year started before January 1, 2004.

You can also use weeknum with datenum and specify a W value of 5 to indicate that the weeks start on Thursday:

weeknum(datenum('01-Jan-2004'):datenum('08-Jan-2004'),5)

ans =

     1     1     1     1     1     1     1     2

The first week of the year that has 4 or more days, based on the specified start day, is considered week one (even if this isn't the first week in the calendar). Any day falling in (or before) this week is given a week number of 1.

weeknum - Week in a year

Syntax

Arguments

Description

Examples

See Also