Finance
AdvanceDate
advance a given date by the given number of time units
Calling Sequence
Parameters
Options
Description
Examples
Compatibility
AdvanceDate(date, n, units, calendar, opts)
AdvanceDate(n, units, calendar, opts)
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
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 formatted using the format deduced from the original date.
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.
with⁡Finance:
AdvanceDate⁡February 6, 2007,10,output=formatted,convention=Unadjusted
February 16, 2007
AdvanceDate⁡February 6, 2006,100,output=formatted
May 17, 2006
AdvanceDate⁡February 6, 2006,1,Weeks,output=formatted
February 13, 2006
AdvanceDate⁡February 6, 2006,1,Years,output=formatted
February 6, 2007
AdvanceDate⁡February 6, 2006,−5,output=formatted
February 1, 2006
date≔AdvanceDate⁡February 6, 2006,−5,output=data
date≔February 1, 2006
datemonthDay
1
datemonth
2
dateyear
2006
Note that last command returned a date data structure. It is printed as a string.
lprint⁡AdvanceDate⁡February 6, 2006,−5,output=data
Record('monthDay' = 1,'month' = 2,'year' = 2006,'format' = "%B %e, %Y",'ModulePrint' = proc (m) Finance:-FormatDate(m) end proc)
The Finance[AdvanceDate] 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[RemoveHoliday]
Download Help Document