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 dos títulos.

Sintaxe

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

Parâmetros

O parâmetro basis aceita os seguintes valores:

Valor retornado

O rendimento da segurança.

Comentários

• As datas são armazenadas como números de série sequenciais para que possam ser usadas nos cálculos. Em DAX, 30 de dezembro de 1899 é o dia 0 e 1º de janeiro de 2008 é 39448 porque é 39.448 dias após 30 de dezembro de 1899.

• A data de liquidação é a data em que um comprador compra um cupom, como um título. A data de vencimento é a data em que um cupom expira. Por exemplo, suponha que um título de 30 anos seja emitido em 1º de janeiro de 2008 e seja comprado 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, que é 30 anos após a data de emissão de 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 desde o início do período do cupom até a data de liquidação (dias acumulados).
  • $\text{DSR}$ = número de dias da 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 uma centena de 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 dado o rendimento esteja próximo ao preço.

• liquidação e vencimento são truncados para inteiros.

• frequência e base são arredondadas para o inteiro mais próximo.

• Um erro será retornado se:

  • liquidação ou vencimento não é uma data válida.
  • settlement ≥ maturity.
  • taxa < 0.
  • pr ≤ 0.
  • redemption ≤ 0.
  • frequência é qualquer número diferente de 1, 2 ou 4.
  • base < 0 ou base > 4.

• Essa função não tem suporte para uso no modo DirectQuery quando usada em colunas calculadas ou regras de RLS (segurança em nível de linha).

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 um título com os termos especificados acima.