advance to the nth given day of the given month

Finance[NthWeekday] - advance to the nth given day of the given month

	Calling Sequence
	NthWeekday(n, weekday, month, year)

Parameters

n	-	positive integer between 1 and 5; day number
date	-	a string containing a date specification in a format recognized by ParseDate or a date data structure
weekday	-	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sun, Mon, Tue, Wed, Thu, Fri, Sat, or an integer between 1 and 7; weekday
month	-	January, February, March, April, May, June, July, August, September, October, November, December, Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec, or an integer between 1 and 12; month
year	-	positive integer; year
opts	-	(optional) equation(s) of the form option = value where option is output; specify options for the NthWeekday command

Description

•	The NthWeekday command returns the first date that follows the given date and falls on the given day of the week. If the specified date already falls on the specified day of the week, the date itself will be returned.

•	The parameter n is the number of the weekday of interest. For example indicates the first weekday of the month, indicates the second weekday of the month, etc.

•	The parameter date must be a date given in one of the formats recognized by the ParseDate command.

•	The parameter weekday is the weekday of interest. It can be given either as a name or as an integer between 1 and 7. In the latter case, 1 represents Sunday, 2 represents Monday, etc.

•	The parameter month is the month. It can be given either as a name or as an integer between 1 and 12. In the latter case, 1 represents January, 2 represents February, etc.

•	The parameter year is the year.

Options

•	output = data or formatted -- Specify the type of output the NthWeekday command should return. If this option is set to data (default) the record containing the data information will be returned. Otherwise the data will be formated using the format deduced from the original date.

Compatibility

•	The Finance[NthWeekday] command was introduced in Maple 15.

•	For more information on Maple 15 changes, see Updates in Maple 15.

Examples

Return 3rd Monday in December, 2008.

(1)

(2)

Note that the last command returned a date data structure. It is printed as a string.

[18, 12, 2006]

(3)

	See Also
	Finance[AddHoliday], Finance[AdjustDate], Finance[Calendar], Finance[Calendars], Finance[IsBusinessDay], Finance[IsEndOfMonth], Finance[IsHoliday], Finance[JoinBusinessDays], Finance[JoinHolidays], Finance[NextWeekday], Finance[RemoveHoliday]