Método WorksheetFunction.Duration (Excel)

Retorna a duração de Macauley para um valor nominal assumido de R$ 100. A duração é definida como a média ponderada do valor presente dos fluxos de caixa e é usada como medida da resposta de um preço de título às alterações no rendimento.

Sintaxe

expressão. Duração (Arg1, Arg2, Arg3, Arg4, Arg5, Arg6)

Expressão Uma variável que representa um objeto WorksheetFunction .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Arg1	Obrigatório	Variantes	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	Obrigatório	Variantes	Vencimento - a data de vencimento do título. A data de vencimento é a data em que o título expira.
Arg3	Obrigatório	Variantes	Cupom - a taxa anual de cupom do título.
Arg4	Obrigatório	Variantes	Lcr - o rendimento anual do título.
Arg5	Obrigatório	Variantes	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	Opcional	Variantes	Base - o tipo de base de contagem diária a ser usado.

Valor de retorno

Double

Comentários

Importante

As datas devem ser inseridas com a função DATA, ou como resultado 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.

A tabela a seguir descreve os valores que podem ser usados para o Arg6.

Base	Base de contagem diária
0 ou omitido	USA (NASD) 30/360
1	Real/real
2	Real/360
3	Real/365
4	Europeu 30/360

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.

Observação

O Visual Basic for Applications (VBA) calcula datas de série diferentemente do Excel. No VBA, o número de série 1 é 31 de dezembro de 1899, em vez de 1 de janeiro de 1900.

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 seja 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, Duração retornará o #VALUE! valor de erro.

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

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

Se base < 0 ou se base > 4, Duração retorna o #NUM! valor de erro.

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

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.