YIELD

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Retorna o rendimento de um título que paga juros periódicos. Use YIELD para calcular o rendimento da obrigação.

Sintaxe

YIELD(<settlement>, <maturity>, <rate>, <pr>, <redemption>, <frequency>[, <basis>])

Parâmetros

O parâmetro basis aceita os seguintes valores:

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.

• Se houver um período de cupom ou menos até o resgate, YIELD será calculado da seguinte maneira:

  $$\text{YIELD} = \frac{(\frac{\text{redemption}}{100} + \frac{\text{rate}}{\text{frequency}}) – (\frac{\text{par}}{100} + (\frac{\text{A}}{\text{E}} \times \frac{\text{rate}}{\text{frequency}}))}{\frac{\text{par}}{100} + (\frac{\text{A}}{\text{E}} \times \frac{\text{rate}}{\text{frequency}})} \times \frac{\text{frequency} \times \text{E}}{\text{DSR}}$$

  em que:

  • $\text{A}$ = número de dias do início do período de um cupom à data de liquidação (dias acumulados).
  • $\text{DSR}$ = número de dias desde a data de liquidação até a data de resgate.
  • $\text{E}$ = número de dias no período de um cupom.

• Se houver mais de um período de cupom até o resgate, YIELD será calculado por meio de cem iterações. A resolução usa o método Newton, com base na fórmula usada para a função PRICE. O rendimento é alterado até que o preço estimado considerando o rendimento esteja perto do preço.

• settlement e maturity serão arredondados para números inteiros.

• frequency e basis serão arredondadas para obter o número inteiro mais próximo.

• Um erro será retornado se:

  • settlement ou maturity não forem datas válidas.
  • settlement ≥ maturity.
  • 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

A seguinte consulta DAX:

EVALUATE
{
  YIELD(DATE(2008,2,15), DATE(2016,11,15), 0.0575, 95.04287, 100, 2,0)
}

Retorna o rendimento de uma obrigação com os termos especificados acima.