OLCFACTORS
Updated 2023-10-05 11:36:33.650000
Syntax
SELECT * FROM [westclintech].[wct].[OLCFACTORS](
<@Settlement, datetime,>
,<@Maturity, datetime,>
,<@LastCoupon, datetime,>
,<@Rate, float,>
,<@Price, float,>
,<@Yield, float,>
,<@Redemption, float,>
,<@Frequency, float,>
,<@Basis, nvarchar(4000),>)
Description
Use the table-valued function OLCFACTORS to return the components used in the calculation of price and yield for a bond with an odd last coupon. OLCFACTORS supports odd last coupon bonds with up to 2 quasi-coupon periods.
Arguments
@Basis
is the type of day count to use. @Basis is an expression of the character string data type category.
{"columns":[{"field":"@Basis","width":313},{"field":"Day count basis","width":277}],"rows":[{"@Basis":"0 , 'BOND'","Day count basis":"US (NASD) 30/360"},{"@Basis":"1 , 'ACTUAL'","Day count basis":"Actual/Actual"},{"@Basis":"2 , 'A360'","Day count basis":"Actual/360"},{"@Basis":"3 , 'A365'","Day count basis":"Actual/365"},{"@Basis":"4 , '30E/360 (ISDA)' , '30E/360' , 'ISDA' , '30E/360 ISDA' , 'EBOND'","Day count basis":"European 30/360"},{"@Basis":"5 , '30/360' , '30/360 ISDA' , 'GERMAN'","Day count basis":"30/360 ISDA"},{"@Basis":"6 , 'NL/ACT'","Day count basis":"No Leap Year/ACT"},{"@Basis":"7 , 'NL/365'","Day count basis":"No Leap Year /365"},{"@Basis":"8 , 'NL/360'","Day count basis":"No Leap Year /360"},{"@Basis":"9 , 'A/364'","Day count basis":"Actual/364"},{"@Basis":"10 , 'BOND NON-EOM'","Day count basis":"US (NASD) 30/360 non-end-of-month"},{"@Basis":"11 , 'ACTUAL NON-EOM'","Day count basis":"Actual/Actual non-end-of-month"},{"@Basis":"12 , 'A360 NON-EOM'","Day count basis":"Actual/360 non-end-of-month"},{"@Basis":"13 , 'A365 NON-EOM'","Day count basis":"Actual/365 non-end-of-month"},{"@Basis":"14 , '30E/360 NON-EOM' , '30E/360 ICMA NON-EOM' , 'EBOND NON-EOM'","Day count basis":"European 30/360 non-end-of-month"},{"@Basis":"15 , '30/360 NON-EOM' , '30/360 ISDA NON-EOM' , 'GERMAN NON-EOM'","Day count basis":"30/360 ISDA non-end-of-month"},{"@Basis":"16 , 'NL/ACT NON-EOM'","Day count basis":"No Leap Year/ACT non-end-of-month"},{"@Basis":"17 , 'NL/365 NON-EOM'","Day count basis":"No Leap Year/365 non-end-of-month"},{"@Basis":"18 , 'NL/360 NON-EOM'","Day count basis":"No Leap Year/360 non-end-of-month"},{"@Basis":"19 , 'A/364 NON-EOM'","Day count basis":"Actual/364 non-end-of-month"}]}
@Frequency
the number of coupon payments per year. For annual payments, @Frequency = 1; for semi-annual, @Frequency = 2; for quarterly, @Frequency = 4; for bimonthly @Frequency = 6; for monthly @Frequency = 12. For bonds with @Basis = 'A/364' or 9, you can enter 364 for payments made every 52 weeks, 182 for payments made every 26 weeks, 91 for payments made every 13 weeks, 28 for payments made every 4 weeks, 14 for payments made every 2 weeks, and 7 for weekly payments. @Frequency is an expression of type float or of a type that can be implicitly converted to float.
@Rate
the security’s annual coupon rate. @Rate is an expression of type float or of a type that can be implicitly converted to float.
@Yield
the security’s annual yield. @Yld is an expression of type float or of a type that can be implicitly converted to float.
@Redemption
the security’s redemption value per 100 face value. @Redemption is an expression of type float or of a type that can be implicitly converted to float.
@Settlement
the settlement date of the security. @Settlement is an expression that returns a datetime or smalldatetime value, or a character string in date format.
@Maturity
the maturity date of the security. @Maturity is an expression that returns a datetime or smalldatetime value, or a character string in date format.
@Price
the price of the bond. @Price is an expression of type float or of a type that can be implicitly converted to float.
@LastCoupon
the last coupon date of the security. The period from the last coupon date until the maturity date defines the odd interest period. All previous coupon dates are assumed to occur at regular periodic intervals as defined by @Frequency. @Lastcoupon is an expression that returns a datetime or smalldatetime value, or a character string in date format.
Return Type
table
{"columns": [{"field": "colName", "headerName": "Name", "header": "name"}, {"field": "colDatatype", "headerName": "Type", "header": "type"}, {"field": "colDesc", "headerName": "Description", "header": "description", "minWidth": 1000}], "rows": [{"id": "d24f182f-9f3c-41f4-9567-b25f57ff0ea2", "colName": "A", "colDatatype": "float", "colDesc": "Number of accrued days from the previous coupon date to the settlement date when the settlement date is less than the last coupon date."}, {"id": "097a8b60-295e-42de-bf23-6ff5486e5193", "colName": "DSC", "colDatatype": "float", "colDesc": "Number of days from the settlement date to the next coupon date when the settlement date is less than the last coupon date."}, {"id": "acdfa2f2-3dc6-444a-a06c-a8c81a74f069", "colName": "E", "colDatatype": "float", "colDesc": "Number of coupon days in the coupon period in which the settlement date falls when the settlement date is less than the last coupon date."}, {"id": "38f4fb45-2b17-4950-b7e1-d8479423874c", "colName": "N", "colDatatype": "int", "colDesc": "Number of coupons between the settlement date and the last coupon date. If the settlement date is greater than the last coupon date then N = 0."}, {"id": "7bef4813-ca66-4202-beba-203a73c2ddc8", "colName": "NCL", "colDatatype": "int", "colDesc": "Number of quasi-coupon periods in the odd period (1 or 2)."}, {"id": "9fe11e22-12c4-438d-845e-e1d3c70381d1", "colName": "A1", "colDatatype": "float", "colDesc": "If N > 0 then NULL, else the number of accrued days in the first quasi-coupon period. If the settlement date is in the first quasi-coupon period then this the number of days from the last coupon date to the settlement date. If the settlement date is in the second coupon period then this is equal to NLL1"}, {"id": "6d9fe1c1-6882-47a5-90b0-1a2d2d8552d1", "colName": "DSC1", "colDatatype": "float", "colDesc": "If N > 0 then NULL, else the number of days from the settlement date to the next quasi-coupon or maturity date. If NCL = 1, the number of days from the settlement date to the maturity date. If NCL = 2 and settlement is in the first quasi-coupon period then the number of days from settlement date to quasicoup, else 0."}, {"id": "12601655-c05f-4fd1-be57-dc9c3e312cf9", "colName": "DLC1", "colDatatype": "float", "colDesc": "Number of days in the first coupon period. If NCL is equal to 1 then this is the number of days from the last coupon date to the maturity date. If NCL = 2 then this is the number of days from the last coupon date to quasicoup."}, {"id": "4267c0f5-a456-4a81-92a1-144f5865b273", "colName": "NLL1", "colDatatype": "float", "colDesc": "\t Normal length of the first quasi-coupon period."}, {"id": "c6da5140-d10f-46a5-93c3-7313d8500219", "colName": "A2", "colDatatype": "float", "colDesc": "Number of days from the quasi-coupon date to the settlement date. If the quasi-coupon date is NULL then A2 is NULL. If settlement date is less than or equal to the quasi-coupon date then A2 = 0"}, {"id": "103acde0-b537-4418-b5e5-dd9bf0d5c85a", "colName": "DSC2", "colDatatype": "float", "colDesc": "Number of days from the greater of quasicoup and settlement date to the maturity date. If quasicoup is NULL then NULL."}, {"id": "d17ea3b2-7e00-4e7c-a56f-b09c936b8f31", "colName": "DLC2", "colDatatype": "float", "colDesc": "Number of days from quasicoup to maturity date. If quasicoup is NULL then NULL."}, {"id": "9e72cca3-47bf-4ab0-8d8d-48f78b5075cc", "colName": "NLL2", "colDatatype": "float", "colDesc": "Normal length of the period from the quasicoup to quasimaturity."}, {"id": "7df99bd7-1da9-448d-85bf-b0d4b2bfabb8", "colName": "quasimaturity", "colDatatype": "datetime", "colDesc": "Implied maturity date with respect to the last coupon date."}, {"id": "2021fab6-2a5c-4205-92a7-455196932d59", "colName": "quasicoup", "colDatatype": "datetime", "colDesc": "Implied next coupon date with respect to the last coupon date when NCL = 2."}, {"id": "9387c0c9-952b-4cd3-b8a7-c2ac870b34f8", "colName": "C", "colDatatype": "float", "colDesc": "Coupon amount"}, {"id": "a224be3e-3643-476d-adc9-674bc41117fb", "colName": "LC", "colDatatype": "float", "colDesc": "Last coupon amount"}, {"id": "a9d757fb-bd6c-487a-bdd0-b2b3cfca8369", "colName": "P", "colDatatype": "float", "colDesc": "Price. If @Yield is NOT NULL then"}, {"id": "0f9add9a-4ef2-4052-92b6-b7b7f73eef59", "colName": "AI", "colDatatype": "float", "colDesc": "\t Accrued interest as of the settlement date."}, {"id": "5b8f169a-ddb6-4a91-8a59-e56d1a199583", "colName": "Y", "colDatatype": "float", "colDesc": "Yield. If @Yield is NOT NULL then Y is the value entered in @Yield otherwise Y is calculated from the input"}]}
Remarks
If @Settlement is NULL then @Settlement = GETDATE().
If @Rate is NULL then @Rate = 0.
If @Redemption is NULL then @Redemption = 100.
If @Frequency is NULL then @Frequency = 2.
If @Basis is NULL then @Basis = 0.
If @Frequency is any number other than 1, 2, 4, 6 or 12, or for @Basis = 'A/364' any number other than 1, 2, 4, 6 or 12 as well as 7, 14, 28, 91, 182 or 364 OLCFACTORS returns an error.
If @Basis is invalid (see above list), OLCFACTORS returns an error.
If @Maturity is NULL then an error is returned.
If @Issue is NULL then an error is returned.
If @LastCoupon is NULL then an error is returned.
If there is only one quasi-coupon period then quasicoup is NULL. Otherwise the next coupon date is calculated using @Frequency, @Basis, and @Maturity.
If there are 2 quasi-coupon periods then DLC1 = NLL1.
Examples
This is a bond with odd short last coupon periods where the settlement date is in the last coupon period.
SELECT *
FROM wct.OLCFACTORS( '2014-10-01', --@Settlement
'2014-12-15', --@Maturity
'2014-09-15', --@Last_interest
0.0225, --@Rate
NULL, --@Price
0.0010, --@Yield
100, --@Redemption
2, --@Frequency
1 --@Basis
);
This produces the following result.
{"columns":[{"field":"A"},{"field":"DSC"},{"field":"E"},{"field":"N","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"NCL","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"A1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"DSC1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"DLC1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"NLL1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"A2"},{"field":"DSC2"},{"field":"DLC2"},{"field":"NLL2"},{"field":"quasicoup"},{"field":"quasimaturity","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"C","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"LC","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"P","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"AI","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"Y","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"}],"rows":[{"A":"NULL","DSC":"NULL","E":"NULL","N":"0","NCL":"1","A1":"16","DSC1":"75","DLC1":"91","NLL1":"181","A2":"NULL","DSC2":"NULL","DLC2":"NULL","NLL2":"NULL","quasicoup":"NULL","quasimaturity":"2015-03-15 00:00:00.000","C":"1.125","LC":"0.56560773480663","P":"100.445329120863","AI":"0.0994475138121547","Y":"0.001"}]}
This is a bond with an odd long last coupon period with a settlement date in the last coupon period.
SELECT *
FROM wct.OLCFACTORS( '2014-10-01', --@Settlement
'2014-12-15', --@Maturity
'2014-03-15', --@Last_interest
0.0225, --@Rate
NULL, --@Price
0.0010, --@Yield
100, --@Redemption
2, --@Frequency
1 --@Basis
);
This produces the following result (which has been reformatted for ease of viewing).
{"columns":[{"field":"A"},{"field":"DSC"},{"field":"E"},{"field":"N","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"NCL","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"A1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"DSC1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"DLC1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"NLL1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"A2","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"DSC2","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"DLC2","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"NLL2","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"quasicoup","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"quasimaturity","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"C","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"LC","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"P","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"AI","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"Y","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"}],"rows":[{"A":"NULL","DSC":"NULL","E":"NULL","N":"0","NCL":"2","A1":"184","DSC1":"0","DLC1":"184","NLL1":"184","A2":"16","DSC2":"75","DLC2":"91","NLL2":"181","quasicoup":"2014-09-15 00:00:00.000","quasimaturity":"2015-03-15 00:00:00.000","C":"1.125","LC":"1.69060773480663","P":"100.445096089033","AI":"1.22444751381215","Y":"0.001"}]}
This is a bond with an odd short last coupon with a settlement date prior to the last coupon date.
SELECT *
FROM wct.OLCFACTORS( '2014-10-01', --@Settlement
'2034-12-15', --@Maturity
'2034-03-15', --@Last_interest
0.0425, --@Rate
NULL, --@Price
0.0400, --@Yield
100, --@Redemption
2, --@Frequency
1 --@Basis
);
This produces the following result.
{"columns":[{"field":"A","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"DSC","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"E","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"N","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"NCL","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"A1"},{"field":"DSC1"},{"field":"DLC1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"NLL1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"A2"},{"field":"DSC2"},{"field":"DLC2","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"NLL2","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"quasicoup","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"quasimaturity","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"C","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"LC","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"P","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"AI","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"Y","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"}],"rows":[{"A":"16","DSC":"165","E":"181","N":"39","NCL":"2","A1":"NULL","DSC1":"NULL","DLC1":"184","NLL1":"184","A2":"NULL","DSC2":"NULL","DLC2":"91","NLL2":"181","quasicoup":"2034-09-15 00:00:00.000","quasimaturity":"2035-03-15 00:00:00.000","C":"2.125","LC":"3.19337016574586","P":"103.4336871715","AI":"0.187845303867403","Y":"0.04"}]}
This is a bond with odd long last coupon period with a settlement date prior to the last coupon date.
SELECT *
FROM wct.OLCFACTORS( '2014-10-01', --@Settlement
'2034-12-15', --@Maturity
'2034-03-15', --@Last_interest
0.0425, --@Rate
103.4336872, --@Price
NULL, --@Yield
100, --@Redemption
2, --@Frequency
1 --@Basis
);
This produces the following result.
{"columns":[{"field":"A","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"DSC","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"E","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"N","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"NCL","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"A1"},{"field":"DSC1"},{"field":"DLC1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"NLL1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"A2"},{"field":"DSC2"},{"field":"DLC2","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"NLL2","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"quasicoup","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"quasimaturity","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"C","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"LC","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"P","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"AI","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"Y","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"}],"rows":[{"A":"16","DSC":"165","E":"181","N":"39","NCL":"2","A1":"NULL","DSC1":"NULL","DLC1":"184","NLL1":"184","A2":"NULL","DSC2":"NULL","DLC2":"91","NLL2":"181","quasicoup":"2034-09-15 00:00:00.000","quasimaturity":"2035-03-15 00:00:00.000","C":"2.125","LC":"3.19337016574586","P":"103.4336872","AI":"0.187845303867403","Y":"0.0399999999795903"}]}
This is an example of a bond paying interest every 26 weeks.
SELECT *
FROM wct.OLCFACTORS( '2014-10-04', --@Settlement
'2014-12-15', --@Maturity
'2014-06-01', --@Last_interest
0.1250, --@Rate
NULL, --@Price
0.1100, --@Yield
100, --@Redemption
182, --@Frequency
9 --@Basis
);
This produces the following result.
{"columns":[{"field":"A"},{"field":"DSC"},{"field":"E"},{"field":"N","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"NCL","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"A1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"DSC1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"DLC1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"NLL1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"A2","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"DSC2","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"DLC2","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"NLL2","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"quasicoup","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"quasimaturity","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"C","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"LC","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"P","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"AI","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"Y","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"}],"rows":[{"A":"NULL","DSC":"NULL","E":"NULL","N":"0","NCL":"2","A1":"125","DSC1":"57","DLC1":"182","NLL1":"182","A2":"0","DSC2":"15","DLC2":"15","NLL2":"182","quasicoup":"2014-11-30 00:00:00.000","quasimaturity":"2015-05-31 00:00:00.000","C":"6.25","LC":"6.76510989010989","P":"100.198974906573","AI":"4.29258241758242","Y":"0.11"}]}
See Also
ODDLINT - Accrued interest for a bond with an odd last coupon
ODDLPRICE - Price of a bond with an odd last coupon
ODDLYIELD - Calculate the YIELD with an odd last period
OLCCONVEXITY - Convexity of a bond with and odd last coupon
OLCDURATION - Duration of a bond with an odd last coupon
OLCMDURATION - Modified duration of a bond with an odd last coupon
RPIFACTORS - Factors for the calculation of the price of a bond that pays regular periodic interest