Financial.Rate(Double, Double, Double, Double, DueDate, Double) Método

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.Core.dll

Source:

Financial.vb

Devuelve un valor que especifica el tipo de interés por período de una anualidad.

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

Parámetros

NPer

Double

Obligatorio. Número total de períodos de pago de la anualidad. Por ejemplo, si se realizan pagos mensuales para amortizar un crédito a cuatro años para la compra de un vehículo, el crédito tiene un total de 4*12 (o 48) períodos de pago.

Pmt

Double

Obligatorio. Pago que se va a realizar en cada período. Normalmente, los pagos contienen capital principal e interés que no cambia durante la vida útil de la anualidad.

PV

Double

Obligatorio. Valor presente o actual de una serie de pagos o ingresos futuros. Por ejemplo, cuando se pide un crédito para comprar un vehículo, el importe del crédito será el valor presente para la entidad crediticia de los pagos mensuales que se van a realizar.

FV

Double

Opcional. Valor futuro o saldo en efectivo deseados una vez realizado el pago final. Por ejemplo, el valor futuro de un crédito es 0 $ porque ése es su valor después del último pago. Sin embargo, si se desea ahorrar 50.000 $ durante 18 años para la educación de un hijo, el valor futuro es 50.000 $. Si se omite, se supone que el valor es 0.

Due

DueDate

Opcional. Objeto de tipo DueDate que indica cuándo vencen los pagos. Este argumento debe ser DueDate.EndOfPeriod si los pagos vencen al final del período o DueDate.BegOfPeriod si los pagos vencen al principio del mismo. Si se omite, se supone que se debe usar el valor DueDate.EndOfPeriod.

Guess

Double

Opcional. Rate devuelve un valor que estima. Si se omite Guess es 0,1 (10 por ciento).

Devoluciones

Double

Tipo de interés por período de una anualidad.

Excepciones

ArgumentException

NPer<= 0.

Ejemplos

En este ejemplo se usa la Rate función para calcular la tasa de interés de un préstamo según el número total de pagos (TotPmts), el importe del pago del préstamo (Payment), el valor actual o el principal del préstamo (PVal), el valor futuro del préstamo (FVal), un número que indica si el pago se debe al principio o al final del período de pago (PayType), y una aproximación de la tasa de interés esperada (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

Comentarios

Una anualidad es una serie de pagos fijos en efectivo realizados durante un período de tiempo. Una anualidad puede ser un préstamo (como una hipoteca de vivienda) o una inversión (por ejemplo, un plan de ahorro mensual).

Para todos los argumentos, el efectivo pagado (como los depósitos al ahorro) se representa mediante números negativos; efectivo recibido (como cheques de dividendos) se representa mediante números positivos.

Rate se calcula por iteración. A partir del valor de Guess, Rate recorre el cálculo hasta que el resultado es preciso en un 0,00001 por ciento. Si Rate no encuentra un resultado después de 20 intentos, se produce un error. Si su estimación es del 10 % y Rate produce un error, pruebe con un valor diferente para Guess.

Consulte también

• ArgumentException
• Resumen financiero