RECEIVED
s’applique à :colonne calculéetable calculéemesurecalcul visuel
Retourne le montant reçu à échéance pour une sécurité entièrement investie.
Syntaxe
RECEIVED(<settlement>, <maturity>, <investment>, <discount>[, <basis>])
Paramètres
Terme | Définition |
---|---|
settlement |
Date de règlement de la sécurité. La date de règlement de la sécurité est la date après la date d’émission lorsque la sécurité est échangée avec l’acheteur. |
maturity |
Date de maturité du titre. La date d’échéance correspond à la date d’expiration du titre. |
investment |
Montant investi dans le titre. |
discount |
Taux d’escompte de la sécurité. |
basis |
(Facultatif) Type de base du nombre de jours à utiliser. Si la base est omise, elle est supposée être 0. Les valeurs acceptées sont répertoriées sous ce tableau. |
Le paramètre basis
accepte les valeurs suivantes :
Basis |
base du nombre de jours |
---|---|
0 ou omis | US (NASD) 30/360 |
1 | Réel/réel |
2 | Réel/360 |
3 | Réel/365 |
4 | Européen 30/360 |
Valeur de retour
Montant reçu à échéance.
Notes
Les dates sont stockées sous forme de numéros de série séquentiels de façon à pouvoir être utilisées dans les calculs. Dans DAX, le 30 décembre 1899 est le jour 0 et le 1er janvier 2008 est 39448 car il est de 39 448 jours après le 30 décembre 1899.
La date de règlement est la date à laquelle un acheteur achète un coupon, tel qu’une obligation. La date d’échéance correspond à la date d’expiration d’un coupon. Par exemple, supposons qu’une obligation de 30 ans soit émise le 1er janvier 2008 et qu’elle est achetée par un acheteur six mois plus tard. La date d’émission serait le 1er janvier 2008, la date de règlement serait le 1er juillet 2008 et la date d’échéance serait le 1er janvier 2038, soit 30 ans après la date d’émission du 1er janvier 2008.
RECEIVED est calculé comme suit :
$$\text{RECEIVED} = \frac{\text{investment}}{1 - (\text{discount} \times \frac{\text{DIM}}{\text{B}})}$$
où :
- $\text{B}$ = nombre de jours dans une année, selon l’année.
- $\text{DIM}$ = nombre de jours entre la date d’émission (issue) et la date d’échéance (maturity).
le règlement et la maturité sont tronqués en entiers.
basis est arrondi à l’entier le plus proche.
Une erreur est retournée si :
- le règlement ou l’échéance n’est pas une date valide.
- settlement ≥ maturity.
- investment ≤ 0.
- discount ≤ 0.
- base < 0 ou base > 4.
Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery lorsqu’elle est utilisée dans les colonnes calculées ou les règles de sécurité au niveau des lignes (RLS).
Exemple
Requête DAX suivante :
Données | Description |
---|---|
15 février 2008 | Date de règlement (problème) |
15 mai 2008 | Échéance |
\$1,000,000.00 | Investissement |
5,75 % | Taux d’escompte de pourcentage |
2 | Base Réel/360 |
EVALUATE
{
RECEIVED(DATE(2008,2,15), DATE(2008,5,15), 1000000.00, 0.0575, 2)
}
Retourne le montant total à recevoir à échéance, pour une obligation avec les termes spécifiés ci-dessus.
[Valeur] |
---|
1014584,6544071 |