NthWeekday - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


Finance

  

NthWeekday

  

advance to the nth given day of the given month

 

Calling Sequence

Parameters

Options

Description

Examples

Compatibility

Calling Sequence

NthWeekday(n, weekday, month, year)

Parameters

n

-

positive integer between 1 and 5; day number

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

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 formatted using the format deduced from the original date.

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 n=1 indicates the first weekday of the month, n=2 indicates the second weekday of the month, etc.

• 

The parameter weekday is the weekday of interest. It can be a name, a string, or an integer between 1 and 7. When using an integer, 1 represents Sunday, 2 represents Monday, etc.

• 

The parameter month is the month. It can be a name, a string, or an integer between 1 and 12. When using an integer, 1 represents January, 2 represents February, etc.

• 

The parameter year is the year.

Examples

withFinance:

Return 3rd Monday in December, 2008.

NthWeekday3,Monday,December,2006,output=formatted

December 18, 2006

(1)

NthWeekday3,Monday,December,2006

18,12,2006

(2)

lprintNthWeekday3,Monday,December,2006

[18, 12, 2006]

NthWeekday3,2,12,2006,output=formatted

December 18, 2006

(3)

Compatibility

• 

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

• 

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

See Also

Finance[AddHoliday]

Finance[AdjustDate]

Finance[Calendar]

Finance[Calendars]

Finance[IsBusinessDay]

Finance[IsEndOfMonth]

Finance[IsHoliday]

Finance[JoinBusinessDays]

Finance[JoinHolidays]

Finance[NextWeekday]

Finance[RemoveHoliday]