Finance - Maple Programming Help

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

Finance

 adjust a non-business day according to the given convention

 Calling Sequence AdjustDate(date, calendar, opts)

Parameters

 date - a string containing a date specification in a format recognized by ParseDate or a date data structure calendar - a name representing a supported calendar (e.g. Toronto, NewYork) or a calendar data structure created using the Calendar constructor opts - (optional) equation(s) of the form option = value where option is one of convention or output; specify options for the AdjustDate command

Options

 • The opts argument can contain one or more of the options shown below.
 • convention =  Unadjusted, Preceding, ModifiedPreceding, Following, ModifiedFollowing, or MonthEndReference -- Provide business day conventions; default value is Following.
 • output = data or formatted -- Specify the type of output the AdjustDate command should return. If this option is set to data (default) the record containing the data information is returned. Otherwise the data is formatted using the format deduced from the original date.

Description

 • The AdjustDate function adjusts a non-business day to the appropriate near business day with respect to the given convention.
 • The parameter date must be a date specified in any of the formats recognized by the ParseDate command.
 • The parameter calendar must be either a name representing a supported calendar (e.g. Toronto, NewYork) or a calendar data structure created using the Calendar constructor.
 • Business day (date rolling) convention specifies the algorithm used to adjust a date in case it is not a valid business day. Here are the business day conventions supported by the package.

Examples

 > $\mathrm{with}\left(\mathrm{Finance}\right):$

Define a calendar with three holidays: September 1, 2006, September 29, 2006, and September 30, 2006.

 > $C≔\mathrm{Calendar}\left(\mathrm{Null}\right):$
 > $\mathrm{Holiday1}≔"September 1, 2006"$
 ${\mathrm{Holiday1}}{:=}{"September 1, 2006"}$ (1)
 > $\mathrm{Holiday2}≔"September 29, 2006"$
 ${\mathrm{Holiday2}}{:=}{"September 29, 2006"}$ (2)
 > $\mathrm{Holiday3}≔"September 30, 2006"$
 ${\mathrm{Holiday3}}{:=}{"September 30, 2006"}$ (3)
 > $\mathrm{AddHoliday}\left(C,\left[\mathrm{Holiday1},\mathrm{Holiday2},\mathrm{Holiday3}\right]\right)$

Adjust the first holiday using various business day conventions.

 > $\mathrm{AdjustDate}\left(\mathrm{Holiday1},C,\mathrm{convention}=\mathrm{Following},\mathrm{output}=\mathrm{formatted}\right)$
 ${"September 2, 2006"}$ (4)
 > $\mathrm{AdjustDate}\left(\mathrm{Holiday1},C,\mathrm{convention}=\mathrm{Preceding},\mathrm{output}=\mathrm{formatted}\right)$
 ${"August 31, 2006"}$ (5)
 > $\mathrm{AdjustDate}\left(\mathrm{Holiday1},C,\mathrm{convention}=\mathrm{ModifiedFollowing},\mathrm{output}=\mathrm{formatted}\right)$
 ${"September 2, 2006"}$ (6)
 > $\mathrm{AdjustDate}\left(\mathrm{Holiday1},C,\mathrm{convention}=\mathrm{ModifiedPreceding},\mathrm{output}=\mathrm{formatted}\right)$
 ${"September 2, 2006"}$ (7)
 > $\mathrm{AdjustDate}\left(\mathrm{Holiday1},C,\mathrm{convention}=\mathrm{MonthEndReference},\mathrm{output}=\mathrm{formatted}\right)$
 ${"September 2, 2006"}$ (8)

Adjust the second holiday using various business day conventions.

 > $\mathrm{AdjustDate}\left(\mathrm{Holiday2},C,\mathrm{convention}=\mathrm{Following},\mathrm{output}=\mathrm{formatted}\right)$
 ${"October 1, 2006"}$ (9)
 > $\mathrm{AdjustDate}\left(\mathrm{Holiday2},C,\mathrm{convention}=\mathrm{Preceding},\mathrm{output}=\mathrm{formatted}\right)$
 ${"September 28, 2006"}$ (10)
 > $\mathrm{AdjustDate}\left(\mathrm{Holiday2},C,\mathrm{convention}=\mathrm{ModifiedFollowing},\mathrm{output}=\mathrm{formatted}\right)$
 ${"September 28, 2006"}$ (11)
 > $\mathrm{AdjustDate}\left(\mathrm{Holiday2},C,\mathrm{convention}=\mathrm{ModifiedPreceding},\mathrm{output}=\mathrm{formatted}\right)$
 ${"September 28, 2006"}$ (12)
 > $\mathrm{AdjustDate}\left(\mathrm{Holiday2},C,\mathrm{convention}=\mathrm{MonthEndReference},\mathrm{output}=\mathrm{formatted}\right)$
 ${"September 28, 2006"}$ (13)

Compatibility

 • The Finance[AdjustDate] command was introduced in Maple 15.
 • For more information on Maple 15 changes, see Updates in Maple 15.