CNLMath : Special Functions : accr_interest_periodic
accr_interest_periodic
Evaluates the interest which has accrued on a security that pays interest periodically.
Synopsis
#include <imsl.h>
float imsl_f_accr_interest_periodic (struct tm issue, struct tm first_coupon, struct tm settlement, float coupon_rate, float par_value, int frequency, int basis)
The type double function is imsl_d_accr_interest_periodic.
Required Arguments
struct tm issue (Input)
The date on which interest starts accruing. For a more detailed discussion on dates see the Usage Notes section of this chapter.
struct tm first_coupon (Input)
First date on which an interest payment is due on the security (e.g. the coupon date). For a more detailed discussion on dates see the Usage Notes section of this chapter.
struct tm settlement (Input)
The date on which payment is made to settle a trade. For a more detailed discussion on dates see the Usage Notes section of this chapter.
float coupon_rate (Input)
Annual interest rate set forth on the face of the security; the coupon rate.
float par_value (Input)
Nominal or face value of the security used to calculate interest payments.
int frequency (Input)
Frequency of the interest payments. It should be one of IMSL_ANNUAL, IMSL_SEMIANNUAL or IMSL_QUARTERLY. For a more detailed discussion on frequency see the Usage Notes section of this chapter.
int basis (Input)
The method for computing the number of days between two dates. It should be one of IMSL_DAY_CNT_BASIS_ACTUALACTUAL, IMSL_DAY_CNT_BASIS_NASD, IMSL_DAY_CNT_BASIS_ACTUAL360, IMSL_DAY_CNT_BASIS_ACTUAL365, or IMSL_DAY_CNT_BASIS_30E360. For a more detailed discussion see the Usage Notes section of this chapter.
Return Value
The accrued interest for a security that pays periodic interest. If no result can be computed, NaN is returned.
Description
Function imsl_f_accr_interest_periodic computes the accrued interest for a security that pays periodic interest.
In the equation below, Ai represents the number of days which have accrued for the i-th quasi-coupon period within the odd period. (The quasi-coupon periods are periods obtained by extending the series of equal payment periods to before or after the actual payment periods.) NC represents the number of quasi-coupon periods within the odd period, rounded to the next highest integer. (The odd period is a period between payments that differs from the usual equally spaced periods at which payments are made.) NLi represents the length of the normal i-th quasi-coupon period within the odd period. NLi is expressed in days.
Function imsl_f_accr_interest_periodic can be found by solving the following:
Example
In this example, imsl_f_accr_interest_periodic computes the accrued interest for a security that pays periodic interest using the US (NASD) 30/360 day count method. The security has a par value of $1,000, the issue date of October 1, 1999, the settlement date of November 3, 1999, the first coupon date of March 31, 2000, and a coupon rate of 6%.
 
#include <stdio.h>
#include <imsl.h>
 
int main()
{
struct tm issue, first_coupon, settlement;
float rate = .06;
float par = 1000.;
int frequency = IMSL_SEMIANNUAL;
int basis = IMSL_DAY_CNT_BASIS_NASD;
float accrint;
 
issue.tm_year = 99;
issue.tm_mon = 9;
issue.tm_mday = 1;
 
first_coupon.tm_year = 100;
first_coupon.tm_mon = 2;
first_coupon.tm_mday = 31;
 
settlement.tm_year = 99;
settlement.tm_mon = 10;
settlement.tm_mday = 3;
 
accrint = imsl_f_accr_interest_periodic (issue, first_coupon,
settlement, rate, par, frequency, basis);
 
printf ("The accrued interest is $%.2f.\n", accrint);
}
Output
 
The accrued interest is $5.33.