WorksheetFunction.MDuration Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Retorna a duração modificada Macauley de um título com um valor par presumido de R$100.

public double MDuration (object Arg1, object Arg2, object Arg3, object Arg4, object Arg5, object Arg6);

Public Function MDuration (Arg1 As Object, Arg2 As Object, Arg3 As Object, Arg4 As Object, Arg5 As Object, Optional Arg6 As Object) As Double

Parâmetros

Arg1

Object

Liquidação - a data de liquidação do título. A data de liquidação do título é aquela após a data de emissão quando o título foi negociado com o cliente.

Arg2

Object

Vencimento - a data de vencimento do título. A data de vencimento é a data em que o título expira.

Arg3

Object

Cupom - a taxa anual de cupom do título.

Arg4

Object

Lcr - o rendimento anual do título.

Arg5

Object

Frequência - o número de pagamentos de cupom por ano. Para pagamentos anuais, frequência = 1; para pagamentos semestrais, frequência = 2; para pagamentos trimestrais, frequência = 4.

Arg6

Object

Base - o tipo de base de contagem diária a ser usado.

Retornos

Double

Comentários

Importante: as datas devem ser inseridas usando a função DATE ou como resultados de outras fórmulas ou funções. Por exemplo, use DATA(2008;5;23) para 23 de maio de 2008. Poderão ocorrer problemas se as datas forem inseridas como texto.

O Microsoft Excel armazena datas como números de série sequenciais para que eles possam ser usados em cálculos. Por padrão, 1 de janeiro de 1900 é o número de série 1, e 1 de janeiro de 2008 é o número de série 39448, porque vem 39.448 dias depois de 1 de janeiro de 1900. O Microsoft Excel para o Macintosh usa um sistema de data diferente como padrão.

A data de liquidação é a data em que um cliente compra um cupom, como um título, por exemplo. A data de vencimento é a data em que o cupom expira. Por exemplo, imagine que um título de 30 anos seja emitido em 1º de janeiro de 2008 e comprado por um cliente seis meses depois. A data de emissão seria 1º de janeiro de 2008, a data de liquidação, 1º de julho de 2008 e a data de vencimento é 1º de janeiro de 2038, ou seja, 30 anos após 1º de janeiro de 2008, a data de emissão.

Liquidação, vencimento, frequência e base são truncados para números inteiros.

Se liquidação ou vencimento não for uma data válida, a MDuration retornará o #VALUE! valor de erro.

Se yld < 0 ou se cupom < 0, MDuration retornará o #NUM! valor de erro.

Se a frequência for qualquer número diferente de 1, 2 ou 4, mDuration retornará o #NUM! valor de erro.

Se base < 0 ou se base > 4, MDuration retornará o #NUM! valor de erro.

Se a liquidação ≥ vencimento, a MDuration retornará o #NUM! valor de erro.

A duração modificada é definida da seguinte maneira:

Figura 1: Equação para duração modificada