AdvanceDate - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


Finance

  

AdvanceDate

  

advance a given date by the given number of time units

 

Calling Sequence

Parameters

Options

Description

Examples

Compatibility

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

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 formatted using the format deduced from the original date.

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.

Examples

withFinance:

AdvanceDateFebruary 6, 2007,10,output=formatted,convention=Unadjusted

February 16, 2007

(1)

AdvanceDateFebruary 6, 2006,100,output=formatted

May 17, 2006

(2)

AdvanceDateFebruary 6, 2006,1,Weeks,output=formatted

February 13, 2006

(3)

AdvanceDateFebruary 6, 2006,1,Years,output=formatted

February 6, 2007

(4)

AdvanceDateFebruary 6, 2006,5,output=formatted

February 1, 2006

(5)

dateAdvanceDateFebruary 6, 2006,5,output=data

dateFebruary 1, 2006

(6)

datemonthDay

1

(7)

datemonth

2

(8)

dateyear

2006

(9)

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

lprintAdvanceDateFebruary 6, 2006,5,output=data

Record('monthDay' = 1,'month' = 2,'year' = 2006,'format' = "%B %e, %Y",'ModulePrint' = proc (m) Finance:-FormatDate(m) end proc)

Compatibility

• 

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]