Financial Toolbox

nweekdate

Date of specific occurrence of weekday in month

Syntax

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

Arguments

n	Nth occurrence of the weekday in a month. Enter as integer from 1 through 5.
Weekday	Weekday whose date you seek. Enter as integer from 1 through 7.
	1	Sunday
	2	Monday
	3	Tuesday
	4	Wednesday
	5	Thursday
	6	Friday
	7	Saturday
Year	Year. Enter as a four-digit integer.
Month	Month. Enter as an integer from 1 through 12.
Same	(Optional) Weekday that must occur in the same week with Weekday. Enter as an integer from 0 through 7, where 0 = ignore (default) and 1 through 7 are as for Weekday.

Description

Date = nweekdate(n, Weekday, Year, Month, Same) returns the serial date number for the specific occurrence of the weekday in the given year and month, and in a week that also contains the weekday Same.

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

Any input can contain multiple values, but if so, all other inputs 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 strings.

Examples

To find the first Thursday in May 2001

• Date = nweekdate(1, 5, 2001, 5); datestr(Date)
  
  ans =
  
  03-May-2001
  

To 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
  

To find the third Monday in February for 2001, 2002, and 2003

• Year = [2001:2003];
  
  Date = nweekdate(3, 2, Year, 2)
  
  Date =
         730901      731265      731629
  
  datestr(Date)
  
  ans =
  
  19-Feb-2001
  18-Feb-2002
  17-Feb-2003
  

See Also

fbusdate, lbusdate, lweekdate

now

opprofit