WorksheetFunction.Duration Méthode

Définition

Espace de noms:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Renvoie la durée de Macauley pour une valeur nominale supposée de 100 $. La durée se définie comme la moyenne pondérée de la valeur actuelle des flux financiers et est utilisée comme mesure de la réponse d'un prix d'obligation à des changements de rendement.

public double Duration (object Arg1, object Arg2, object Arg3, object Arg4, object Arg5, object Arg6);

Public Function Duration (Arg1 As Object, Arg2 As Object, Arg3 As Object, Arg4 As Object, Arg5 As Object, Optional Arg6 As Object) As Double

Paramètres

Arg1

Object

Règlement - date de règlement du titre. La date de règlement du titre est la date, après la date d'émission, à laquelle le titre est remis à l'acheteur.

Arg2

Object

Échéance - date d'échéance du titre. La date d'échéance est la date à laquelle le titre arrive à expiration.

Arg3

Object

Coupon, le taux de coupon annuel du titre.

Arg4

Object

Rdt - rendement annuel du titre.

Arg5

Object

Fréquence, le nombre de coupons payés par an. Pour les paiements annuels, fréquence = 1 ; pour les paiements biannuels, fréquence = 2; pour les paiements trimestriels, fréquence = 4.

Arg6

Object

Base - type de base de nombre de jours à utiliser.

Retours

Double

Remarques

Important : les dates doivent être entrées à l’aide de la fonction DATE ou en tant que résultats d’autres formules ou fonctions. Par exemple, utilisez DATE(2008,5,23) pour le 23 mai 2008. Des problèmes peuvent se produire si des dates sont saisies sous forme de texte.

0 ou non spécifiée	Américain (NASD) 30/360
1	Réel/réel
2	Réel/360
3	Réel/365
4	Européen 30/360

Microsoft Excel stocke les dates comme des numéros de série séquentiels pour pouvoir les utiliser dans des calculs. Par défaut, le 1er janvier 1900 est le numéro 1 et le 1er janvier 2008 est le numéro 39448 car il survient 39 448 jours après le 1er janvier 1900. Microsoft Excel pour Macintosh utilise un autre système de date par défaut.

La date de règlement est la date à laquelle un acheteur acquiert un coupon (une obligation, par exemple). La date d'échéance est la date à laquelle un coupon arrive à expiration. Par exemple, imaginez qu'une obligation à 30 ans est émise le 1er janvier 2008 et est achetée six mois plus tard. La date d'émission est le 1er janvier 2008, la date de règlement est le 1er juillet 2008 et la date d'échéance est le 1er janvier 2038, soit 30 ans après la date d'émission.

Le règlement, l'échéance, la fréquence et la base sont raccourcis à des entiers.

Si le règlement ou l’échéance n’est pas une date valide, Duration renvoie la #VALUE ! Autrement, la méthode INDEX renvoie la valeur d'erreur #REF!.

Si coupon < 0 ou si yld < 0, Duration renvoie la #NUM ! Autrement, la méthode INDEX renvoie la valeur d'erreur #REF!.

Si la fréquence est un nombre autre que 1, 2 ou 4, duration renvoie la #NUM ! Autrement, la méthode INDEX renvoie la valeur d'erreur #REF!.

Si la base < 0 ou si la base > 4, Duration renvoie la #NUM ! Autrement, la méthode INDEX renvoie la valeur d'erreur #REF!.

Si le règlement ≥ l’échéance, Duration renvoie le #NUM ! Autrement, la méthode INDEX renvoie la valeur d'erreur #REF!.