ODDFYIELD
Aplica-se a:
Coluna calculadaTabela calculadaMedidaCálculo visual
Retorna o rendimento de um título que tem um período inicial (curto ou longo) indefinido.
Sintaxe
ODDFYIELD(<settlement>, <maturity>, <issue>, <first_coupon>, <rate>, <pr>, <redemption>, <frequency>[, <basis>])
Parâmetros
| Termo | Definição |
|---|---|
| settlement | A data de liquidação do título. A data de liquidação do título será a data posterior à data de emissão quando o título for negociado com o comprador. |
| maturity | A data de vencimento do título. A data de vencimento é a data de expiração do título. |
| problema | A data de emissão do título. |
| first_coupon | A data inicial do cupom do título. |
| rate | A taxa de juros do título. |
| pr | O preço do título. |
| redemption | O valor de resgate do título por US$ 100 de valor nominal. |
| frequência | O número de pagamentos de cupons por ano. Para pagamentos anuais: frequency = 1, para pagamentos semestrais: frequency = 2 e para pagamentos trimestrais: frequency = 4. |
| basis | (Opcional) O tipo de base de contagem de dias a ser usado. Caso basis seja omitido, ele será considerado 0. Os valores aceitos estão listados na tabela abaixo. |
O parâmetro basis aceita os seguintes valores:
| Base | Base de contagem diária |
|---|---|
| 0 ou omitido | US (NASD) 30/360 |
| 1 | Real/real |
| 2 | Real/360 |
| 3 | Real/365 |
| 4 | Europeu 30/360 |
Valor Retornado
O rendimento do título.
Comentários
As datas são armazenadas como números de série sequenciais para que possam ser usadas nos cálculos. No DAX, 30 de dezembro de 1899 será o dia 0 e 1º de janeiro de 2008 será o dia 39448 porque são 39.448 dias após 30 de dezembro de 1899.
A data de liquidação será a data em que o comprador adquire um cupom, como um título de dívida. A data de vencimento será a data de expiração de um cupom. Por exemplo, suponha que um título de dívida de 30 anos seja emitido em 1º de janeiro de 2008 e adquirido por um comprador seis meses depois. A data de emissão seria 1º de janeiro de 2008, a data de liquidação seria 1º de julho de 2008 e a data de vencimento seria 1º de janeiro de 2038, ou seja, 30 anos após a data de emissão em 1º de janeiro de 2008.
A função ODDFYIELD será calculada usando um método iterativo. Ela usará o método de Newton com base na fórmula usada para a função ODDFPRICE. O rendimento será alterado por meio de iterações de 100 até que o preço estimado de um determinado rendimento esteja próximo do preço. Confira ODDFPRICE para obter a fórmula que ODDFYIELD usa.
settlement, maturity, issue e first_coupon serão arredondados para obter números inteiros.
basis e frequency serão arredondados para o número inteiro mais próximo.
Um erro será retornado se:
- settlement, maturity, issue ou first_coupon não for válido.
- maturity > first_coupon > settlement > issue não é aceitável.
- rate < 0.
- pr ≤ 0.
- redemption ≤ 0.
- frequency for qualquer número diferente de 1, 2 ou 4.
- basis < 0 ou basis > 4.
Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.
Exemplo
| Dados | Descrição de argumento |
|---|---|
| 11 de novembro de 2008 | Data de liquidação |
| 1º de março de 2021 | Data de vencimento |
| 15 de outubro de 2008 | Data de emissão |
| 1º de março de 2009 | Data inicial do cupom |
| 5,75% | Cupom percentual |
| 84,50 | Preço |
| 100 | Valor de quitação |
| 2 | A frequência é semestral |
| 0 | Base de 30/360 |
A seguinte consulta DAX:
EVALUATE
{
ODDFYIELD(DATE(2008,11,11), DATE(2021,3,1), DATE(2008,10,15), DATE(2009,3,1), 0.0575, 84.50, 100, 2, 0)
}
Retorna o rendimento de um título que tem um período inicial (curto ou longo) indefinido usando os termos especificados acima.
| [Value] |
|---|
| 0,0772455415972989 |