Método WorksheetFunction.OddFYield (Excel)

Retorna o rendimento de um título com um período inicial incompleto (curto ou longo).

Sintaxe

expressão. OddFYield (Arg1, Arg2, Arg3, Arg4, Arg5, Arg6, Arg7, Arg8, Arg9)

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 Emissão - a data de emissão do título.
Arg4 Obrigatório Variantes Prim_cupom - a data do primeiro cupom do título.
Arg5 Obrigatório Variantes Taxa - a taxa de juros do título.
Arg6 Obrigatório Variantes Pr - o preço do título.
Arg7 Obrigatório Variantes Resgate - o valor de resgate do título por R$ 100 de valor nominal.
Arg8 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.
Arg9 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 Arg9.

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, emissão, prim_cupom e base são truncados para números inteiros.

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

Se a taxa < 0 ou se pr ≤ 0, OddFYield retornará o #NUM! valor de erro.

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

A condição de data a seguir deve ser atendida; caso contrário, OddFYield retorna o #NUM! valor de erro: maturidade > first_coupon > problema de liquidação > .

O Excel usa uma técnica iterativa para calcular OddFYield. Essa função usa o método Newton com base na fórmula usada para a função OddFPrice. O rendimento é alterado por 100 iterações até o preço estimado com o rendimento fornecido aproximar-se do preço. Consulte OddFPrice para obter a fórmula que OddFYield usa.

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.