WorksheetFunction.Xirr(Object, Object, Object) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Returns the internal rate of return for a schedule of cash flows that is not necessarily periodic. To calculate the internal rate of return for a series of periodic cash flows, use the IRR function.
public double Xirr (object Arg1, object Arg2, object Arg3);Public Function Xirr (Arg1 As Object, Arg2 As Object, Optional Arg3 As Object) As DoubleParameters
- Arg1
- Object
Values - a series of cash flows that corresponds to a schedule of payments in dates. The first payment is optional and corresponds to a cost or payment that occurs at the beginning of the investment. If the first value is a cost or payment, it must be a negative value. All succeeding payments are discounted based on a 365-day year. The series of values must contain at least one positive and one negative value.
- Arg2
- Object
Dates - a schedule of payment dates that corresponds to the cash flow payments. The first payment date indicates the beginning of the schedule of payments. All other dates must be later than this date, but they may occur in any order. Dates should be entered by using the DATE function, or as results of other formulas or functions. For example, use DATE(2008,5,23) for the 23rd day of May, 2008. Problems can occur if dates are entered as text.
- Arg3
- Object
Guess - a number that you guess is close to the result of Xirr.
Returns
Remarks
Microsoft Excel stores dates as sequential serial numbers so they can be used in calculations. By default, January 1, 1900 is serial number 1, and January 1, 2008 is serial number 39448 because it is 39,448 days after January 1, 1900. Microsoft Excel for the Macintosh uses a different date system as its default.
Numbers in dates are truncated to integers.
Xirr expects at least one positive cash flow and one negative cash flow; otherwise, Xirr returns the #NUM! error value.
If any number in dates is not a valid date, Xirr returns the #VALUE! error value.
If any number in dates precedes the starting date, Xirr returns the #NUM! error value.
If values and dates contain a different number of values, Xirr returns the #NUM! error value.
In most cases you do not need to provide guess for the Xirr calculation. If omitted, guess is assumed to be 0.1 (10 percent).
Xirr is closely related to Xnpv(Object, Object), the net present value function. The rate of return calculated by Xirr is the interest rate corresponding to XNPV = 0.
Excel uses an iterative technique for calculating Xirr. Using a changing rate (starting with guess), Xirr cycles through the calculation until the result is accurate within 0.000001 percent. If Xirr can't find a result that works after 100 tries, the #NUM! error value is returned. The rate is changed until:
Figure 1: Equation
where:
di = the ith, or last, payment date.
d1 = the 0th payment date.
Pi = the ith, or last, payment.