Finance[AdvanceDate] - advance a given date by the given number of time units
|
Calling Sequence
|
|
AdvanceDate(date, n, units, calendar, opts)
AdvanceDate(n, units, calendar, opts)
|
|
Parameters
|
|
date
|
-
|
a string containing a date specification in a format recognized by ParseDate or a date data structure
|
n
|
-
|
integer; number of units
|
units
|
-
|
Days, Weeks, Months, or Years; time units
|
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 AdvanceDate command
|
|
|
|
|
Description
|
|
•
|
The AdvanceDate command advances a given date by the given number of time units. If the advanced date falls on a holiday according to the given calendar it will be adjusted to the appropriate 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. If this parameter is missing, the global evaluation date is used.
|
•
|
The parameter units specifies the time units in which the increment is measured. The number of units n can be either positive or negative.
|
•
|
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.
|
|
|
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 Unadjusted. See AdjustDate for more details.
|
•
|
output = data or formatted -- Specify the type of output the AdvanceDate 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[AdvanceDate] command was introduced in Maple 15.
|
|
|
Examples
|
|
>
|
|
>
|
|
| (1) |
>
|
|
| (2) |
>
|
|
| (3) |
>
|
|
| (4) |
>
|
|
| (5) |
>
|
|
| (6) |
>
|
|
| (7) |
>
|
|
| (8) |
>
|
|
| (9) |
Note that last command returned a date data structure. It is printed as a string.
>
|
|
Record(monthDay = 1, month = 2, year = 2006, format = "%B %e, %Y", ModulePrint = proc (m) Finance:-FormatDate(m) end proc)
| |
|
|