advance to the nth given day of the given month - Maple Help

Online Help

All Products    Maple    MapleSim

Home : Support : Online Help : Mathematics : Finance : Date Arithmetic : Finance/NthWeekday

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

Calling Sequence

NthWeekday(n, weekday, month, year)




positive integer between 1 and 5; day number



Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sun, Mon, Tue, Wed, Thu, Fri, Sat, or an integer between 1 and 7; weekday



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



positive integer; year



(optional) equation(s) of the form option = value where option is output; specify options for the NthWeekday command



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 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.



Return 3rd Monday in December, 2008.


December 18, 2006





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


[18, 12, 2006]


December 18, 2006


See Also

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

Download Help Document

Was this information helpful?

Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam