COUPNUM
傳回結算日期與到期日之間應付的優惠券數目，四捨五入至最接近的整個優惠券。
語法
COUPNUM(<settlement>, <maturity>, <frequency>[, <basis>])
參數
| 術語 | 定義 |
|---|---|
settlement |
證券的結算日期。 證券結算日期是證券交易給買家的發行日期之後的日期。 |
maturity |
安全性的到期日。 到期日是安全性到期的日期。 |
frequency |
每年的優惠券付款數目。 對於年度付款，frequency = 1;若為半年，frequency = 2;針對每季，frequency = 4。 |
basis |
（選擇性）要使用的日計數基礎類型。 如果省略 basis，則會假設為 0。 下表下方列出可接受的值。 |
basis 參數接受下列值：
Basis |
日計數基礎 |
|---|---|
| 0 或省略 | 美國 （NASD） 30/360 |
| 1 | 實際/實際 |
| 2 | 實際/360 |
| 3 | 實際/365 |
| 4 | 歐洲 30/360 |
傳回值
結算日期與到期日之間應付的優待券數目。
言論
日期會儲存為循序號，以便用於計算中。 在 DAX,1899年12月30日是第0天，2008年1月1日是39448年，因為它是1899年12月30日之後的39,448天。
結算日期是買家購買優惠券的日期，例如債券。 到期日是優惠券到期的日期。 例如，假設 2008 年 1 月 1 日發行 30 年期債券，並在六個月後由買家購買。 發行日期為 2008 年 1 月 1 日，結算日期為 2008 年 7 月 1 日，到期日為 2038 年 1 月 1 日，也就是 2008 年 1 月 1 日發行日期之後的 30 年。
settlement 和 maturity 會截斷為整數。
frequency 和 basis 會四捨五入為最接近的整數。
如果：
- settlement 或 maturity 不是有效的日期。
- settlement ≥ maturity。
- frequency 是 1、2 或 4 以外的任何數位。
- basis < 0 或 basis > 4。
在匯出數據行或數據列層級安全性 （RLS） 規則中使用時，不支援在 DirectQuery 模式中使用此函式。
例
| 數據 | 描述 |
|---|---|
| 25-Jan-07 | 結算日期 |
| 15-Nov-08 | 到期日 |
| 2 | 半年優惠券（見上圖） |
| 1 | 實際/實際基礎（請參閱上圖） |
下列 DAX 查詢：
EVALUATE
{
COUPNUM(DATE(2007,1,25), DATE(2008,11,15), 2, 1)
}
傳回具有上述指定條款之債券的息票付款數目。
| [值] |
|---|
| 4 |