Financial.Rate(Double, Double, Double, Double, DueDate, Double) Метод

Определение

Возвращает значение, указывающее процентную ставку за период аннуитета.

public static double Rate(double NPer, double Pmt, double PV, double FV = 0, Microsoft.VisualBasic.DueDate Due = Microsoft.VisualBasic.DueDate.EndOfPeriod, double Guess = 0.1);
static member Rate : double * double * double * double * Microsoft.VisualBasic.DueDate * double -> double
Public Function Rate (NPer As Double, Pmt As Double, PV As Double, Optional FV As Double = 0, Optional Due As DueDate = Microsoft.VisualBasic.DueDate.EndOfPeriod, Optional Guess As Double = 0.1) As Double

Параметры

NPer
Double

Обязательно. Общее количество периодов оплаты в аннуитетах. Например, при ежемесячных выплатах по четырехгодичному кредиту на машину число периодов выплат равно 4*12 (или 48).

Pmt
Double

Обязательно. Платеж, который необходимо выполнить каждый период. Обычно платежи включают основную сумму и проценты, которые не изменяются на протяжении всего периода выплат.

PV
Double

Обязательно. Текущее значение или значение сегодня из ряда будущих платежей или квитанций. Например, при получении кредита на покупку автомобиля сумма кредита для кредитора равноценна будущим ежемесячным платежам по кредиту.

FV
Double

Optional. Будущая стоимость или денежный баланс, который вы хотите после того, как вы сделаете окончательный платеж. Например, будущая стоимость кредита составляет \0 долларов, так как это его стоимость после окончательного платежа. Тем не менее, если вы хотите сохранить \$50 000 более 18 лет для образования вашего ребенка, то \$50000 является будущим значением. Если этот аргумент не задан, используется значение 0.

Due
DueDate

Optional. Объект типа DueDate , указывающий, когда должны быть выплаты. Этот аргумент должен быть либо DueDate.EndOfPeriod в том случае, если платежи должны выполняться в конце периода оплаты, либо DueDate.BegOfPeriod если платежи должны быть в начале периода. Если опущено, DueDate.EndOfPeriod предполагается.

Guess
Double

Optional. Значение, которое вы оцениваете, возвращается Rate. Если опущено, Guess значение равно 0,1 (10%).

Возвращаемое значение

Процентная ставка за период аннуитета.

Исключения

NPer <= 0.

Примеры

В этом примере функция используется Rate для вычисления процентной ставки кредита с учетом общего количества платежей (TotPmts), суммы кредита (Payment), текущей стоимости или субъекта кредита (), будущего значения кредита (PValFVal), числа, указывающего, должен ли платеж в начале или конце периода оплаты (PayType). и приближение ожидаемой процентной ставки (Guess).

Sub TestRate()
    Dim PVal, Payment, TotPmts, APR As Double
    Dim PayType As DueDate

    ' Define percentage format.
    Dim Fmt As String = "##0.00"
    Dim Response As MsgBoxResult
    ' Usually 0 for a loan.
    Dim FVal As Double = 0
    ' Guess of 10 percent.
    Dim Guess As Double = 0.1
    PVal = CDbl(InputBox("How much did you borrow?"))
    Payment = CDbl(InputBox("What's your monthly payment?"))
    TotPmts = CDbl(InputBox("How many monthly payments do you have to make?"))
    Response = MsgBox("Do you make payments at the end of the month?", MsgBoxStyle.YesNo)
    If Response = MsgBoxResult.No Then
        PayType = DueDate.BegOfPeriod
    Else
        PayType = DueDate.EndOfPeriod
    End If
    APR = (Rate(TotPmts, -Payment, PVal, FVal, PayType, Guess) * 12) * 100

    MsgBox("Your interest rate is " & Format(CInt(APR), Fmt) & " percent.")
End Sub

Комментарии

Выплатами называется ряд фиксированных платежей наличными, которые выполняются в определенный период времени. Это может быть заём (например, ипотека) или инвестиция (например, сберегательный вклад с ежемесячным пополнением).

Все аргументы, которым соответствуют выплачиваемые денежные средства (например, сберегательные вклады), представляются отрицательными числами, а получаемые (например, дивиденды) — положительными.

Rate вычисляется по итерации. Начиная со значения Guess, Rate цикличен по расчету до тех пор, пока результат не будет точным в пределах 0,00001 процента. Если Rate не удается найти результат после 20 попыток, он завершается ошибкой. Если ваше предположение равно 10 процентов и Rate завершается ошибкой, попробуйте использовать другое значение.Guess

Применяется к

См. также раздел