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

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.
rate	A taxa de cupom anual do título.
pr	O preço do título por US$ 100 de valor nominal.
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.

• 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

Dados	Descrição
15-fev-08	Data de liquidação
15-nov-16	Data de vencimento
5,75%	Cupom percentual
95,04287	Preço
US$ 100	Valor de resgate
2	A frequência é semestral (confira acima)
0	Base 30/360 (confira acima)

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.

[Value]
0,0650000068807314