nweekdate

Date of specific occurrence of weekday in month

Syntax

Date = nweekdate(n,Weekday,Year,Month)

Date = nweekdate(___,Same,outputType)

Description

Date = nweekdate(n,Weekday,Year,Month) returns the date number for the specific occurrence of the weekday in the given Year and Month.

Any input argument can contain multiple values, but if so, all other input arguments must contain the same number of values or a single value that applies to all. For example, if Year is a 1-by-n vector of integers, then Month must be a 1-by-n vector of integers or a single integer. Date is then a 1-by-n vector of date numbers.

Use the function datestr to convert serial date numbers to formatted date character vectors.

Date = nweekdate(___,Same,outputType) returns the date number for the specific occurrence of the weekday in the given Year and Month and also contains the optional arguments for weekday Same and outputType.

Examples

Determine the Date of a Specific Occurrence of a Weekday in a Month

Find the first Thursday in May 2001.

Date = nweekdate(1, 5, 2001, 5); 
datestr(Date)

ans = 
'03-May-2001'

Find the first Thursday in May 2001 returned as a datetime array.

Date = nweekdate(1, 5, 2001, 5,[],'datetime')

Date = datetime
   03-May-2001

Find the first Thursday in a week that also contains a Wednesday in May 2001.

Date = nweekdate(2, 5, 2001, 5, 4); 
datestr(Date)

ans = 
'10-May-2001'

Find the third Monday in February for 2001, 2002, and 2003.

Year = [2001:2003];
Date = nweekdate(3, 2, Year, 2);
datestr(Date)

ans = 3x11 char array
    '19-Feb-2001'
    '18-Feb-2002'
    '17-Feb-2003'

Input Arguments

n — Nth occurrence of weekday in a month

integer with value 1 through 5 | vector of integers with values 1 through 5

Nth occurrence of the weekday in a month, specified as an integer or a vector of integers from 1 through 5.

If n is larger than the last occurrence of Weekday, the output Date = 0.

Data Types: single | double

Weekday — Weekday whose date you seek

integer with value 1 through 7 | vector of integers with values 1 through 7

Weekday whose date you seek, specified as an integer or a vector of integers from 1 through 7.

• 1 — Sunday

• 2 — Monday

• 3 — Tuesday

• 4 — Wednesday

• 5 — Thursday

• 6 — Friday

• 7 — Saturday

Data Types: single | double

Year — Year to determine occurrence of weekday

4-digit integer | vector of 4-digit integers

Year to determine occurrence of weekday, specified as a 4-digit integer or vector of 4-digit integers.

Data Types: single | double

Month — Month to determine occurrence of weekday

integer with value 1 through 12 | vector of integers with values 1 through 12

Month to determine occurrence of weekday, specified as an integer or vector of integers with values 1 through 12.

Data Types: single | double

Same — Weekday that must occur in same week with Weekday

0 = ignore (default) | integer with value 0 through 7 | vector of integers with values 0 through 7

Weekday that must occur in the same week with Weekday, specified as an integer or a vector of integers from 0 through 7, where 0 = ignore (default) and 1 through 7 are as for Weekday.

Data Types: single | double

outputType — Year to determine days

'datenum' (default) | character vector with values 'datenum' or 'datetime'

A character vector specified as either 'datenum' or 'datetime'. The output Date is in serial date format if 'datenum' is specified, or datetime format if 'datetime' is specified. By default the output Date is in serial date format.

Data Types: single | double

Output Arguments

Date — Date of specific occurrence of weekday in month

serial date number | date character vector

Date of specific occurrence of weekday in month, returned as a serial date number or date character vector.

The type of the output for Date depends on the input outputType. If this variable is 'datenum', Date is a serial date number. If outputType is 'datetime', then Date is a datetime array. By default, outputType is set to 'datenum'.