advance a given date by the given number of time units

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.

•	For more information on Maple 15 changes, see Updates 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)

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