Main Content

tbillyield2disc

Convert Treasury bill yield to equivalent discount

collapse all in page

Syntax

Discount = tbillyield2disc(Yield,Settle,Maturity)
Discount = tbillyield2disc(___,Type)

Description

Discount = tbillyield2disc(Yield,Settle,Maturity) converts the yield on some Treasury bills into their respective discount rates.

example

Discount = tbillyield2disc(___,Type) adds an optional argument for Type.

example

Examples

collapse all

This example uses:

Open Live Script

Given a Treasury bill with these characteristics, compute the discount rate.

Yield = 0.0497;
Settle = '01-Oct-02';
Maturity = '31-Mar-03';

Discount = tbillyield2disc(Yield,Settle,Maturity)
Discount = 
0.0485

This example uses:

Open Live Script

Given a Treasury bill with these characteristics, compute the discount rate using datetime inputs.

Yield = 0.0497;
Settle = datetime(2002,10,1);
Maturity = datetime(2003,3,31);

Discount = tbillyield2disc(Yield,Settle,Maturity)
Discount = 
0.0485

Input Arguments

collapse all

Yield of Treasury bills, specified as a scalar of a NTBILLS-by-1 vector of decimal values.

Data Types: double

Settlement date of the Treasury bill, specified as a scalar or a NTBILLS-by-1 vector using a datetime array, string array, or date character vectors.

To support existing code, tbillyield2disc also accepts serial date numbers as inputs, but they are not recommended.

Data Types: char | string | datetime

Maturity date of the Treasury bill, specified as a scalar or a NTBILLS-by-1 vector using a datetime array, string array, or date character vectors.

To support existing code, tbillyield2disc also accepts serial date numbers as inputs, but they are not recommended.

Data Types: char | string | datetime

(Optional) Yield type (determines how to interpret values entered in Yield), specified as a numeric value of 1 or 2 using a scalar or a NTBILLS-by-1 vector.

Note

The bond-equivalent yield basis is actual/365. The money-market yield basis is actual/360.

Data Types: double

Output Arguments

collapse all

Discount rates of the Treasury bills, returned as a NTBILLS-by-1 vector.

References

[1] SIA Fixed Income Securities Formulas for Price, Yield, and Accrued Interest. Volume 1, 3rd edition, pp. 44–45.

[2] Krgin, D. Handbook of Global Fixed Income Calculations. Wiley, 2002.

[3] Stigum, M., Robinson, F. Money Market and Bond Calculation. McGraw-Hill, 1996.

Version History

Introduced before R2006a

expand all

See Also

|

Topics