Método WorksheetFunction.YieldMat (Excel)
Retorna o rendimento anual de um título que paga juros no vencimento.
Sintaxe
expressão. YieldMat (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 | Emissão - a data de emissão do título, expressa como um número de série de data. |
| Arg4 | Obrigatório | Variantes | Taxa - a taxa de juros do título na data de emissão. |
| Arg5 | Obrigatório | Variantes | Pr - o preço do título por R$ 100 de valor nominal. |
| 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, emissão e base são truncados para números inteiros.
Se liquidação, vencimento ou problema não for uma data válida, YieldMat retornará o #VALUE! valor de erro.
Se a taxa < 0 ou se pr ≤ 0, YieldMat retornará o #NUM! valor de erro.
Se base < 0 ou se base > 4, YieldMat retornará o #NUM! valor de erro.
Se a liquidação ≥ vencimento, YieldMat 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.