Main Content

beytbill

Bond equivalent yield for Treasury bill

collapse all in page

Syntax

Yield = beytbill(Settle,Maturity,Discount)

Description

Yield = beytbill(Settle,Maturity,Discount) returns the bond equivalent yield for a Treasury bill.

example

Examples

collapse all

Open Live Script

This example shows how to find the bond equivalent yield for a Treasury bill that has a settlement date of February 11, 2000, a maturity date of August 7, 2000, and a discount rate is 5.77.

Yield = beytbill(datetime(2000,2,11),datetime(2000,8,7), 0.0577)
Yield = 
0.0602

Input Arguments

collapse all

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. Settle must be earlier than Maturity.

To support existing code, beytbill 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, beytbill also accepts serial date numbers as inputs, but they are not recommended.

Data Types: char | string | datetime

Discount rate of the Treasury bill, specified as a scalar of a NTBILLS-by-1 vector of decimal fraction values.

Data Types: double

Output Arguments

collapse all

Treasury bill yield, returned as a scalar or NTBILLS-by-1 vector.

Note

The number of days to maturity is typically quoted as: md - sd - 1. A NaN is returned for all cases in which negative prices are implied by the discount rate, Discount, and the number of days between Settle and Maturity.

Version History

Introduced before R2006a

expand all

See Also

| |

Topics