YIELD

gælder for:beregnet kolonneberegnet tabelberegning af målingvisualisering

Returnerer afkastet for et værdipapir, der betaler periodiske renter. Brug YIELD til at beregne obligationsafkastet.

Syntaks

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

Parametre

Parameteren basis accepterer følgende værdier:

Returværdi

Afkastet på værdipapiret.

Bemærkninger

• Datoer gemmes som sekventielle serienumre, så de kan bruges i beregninger. I DAXer 30. december 1899 dag 0, og den 1. januar 2008 er 39448, fordi den er 39.448 dage efter den 30. december 1899.

• Afregningsdatoen er den dato, hvor en køber køber en kupon, f.eks. en obligation. Udløbsdatoen er den dato, hvor en kupon udløber. Antag f.eks., at der udstedes en 30-årig obligation den 1. januar 2008 og købes af en køber seks måneder senere. Udstedelsesdatoen er den 1. januar 2008, afregningsdatoen er den 1. juli 2008, og udløbsdatoen er den 1. januar 2038, hvilket er 30 år efter udstedelsesdatoen den 1. januar 2008.

• Hvis der er én kuponperiode eller mindre indtil indløsning, beregnes YIELD på følgende måde:

  $$\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}}$$

  hvor:

  • $\text{A}$ = antal dage fra begyndelsen af kuponperioden til afregningsdatoen (påløbne dage).
  • $\text{DSR}$ = antal dage fra afregningsdatoen til indløsningsdatoen.
  • $\text{E}$ = antal dage i kuponperioden.

• Hvis der er mere end én kuponperiode indtil indløsning, beregnes YIELD ved hjælp af hundrede gentagelser. Løsningen bruger metoden Newton baseret på den formel, der bruges til funktionen PRICE. Afkastet ændres, indtil den anslåede pris på grund af afkastet er tæt på prisen.

• settlement og maturity afkortes til heltal.

• frekvens og basis afrundes til det nærmeste heltal.

• Der returneres en fejl, hvis:

  • settlement eller maturity er ikke en gyldig dato.
  • settlement ≥ udløbsdato.
  • rate < 0.
  • pr. ≤ 0.
  • indløsning ≤ 0.
  • frequency er et andet tal end 1, 2 eller 4.
  • basis < 0 eller basis > 4.

• Denne funktion understøttes ikke til brug i DirectQuery-tilstand, når den bruges i beregnede kolonner eller RLS-regler (row-level security).

Eksempel

Følgende DAX forespørgsel:

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

Returnerer afkastet på en obligation med de vilkår, der er angivet ovenfor.