共用方式為


COUPNUM

適用於:計算結果列匯出數據表量值視覺計算

結算日期和到期日期之間可支付的息票數量,無條件進位到最靠近的完整息票。

語法

COUPNUM(<settlement>, <maturity>, <frequency>[, <basis>])

參數

詞彙 定義
settlement 證券的結算日期。 證券結算日期是在發行日之後,證券賣給買方的日期。
maturity 證券到期日。 到期日是證券到期的日期。
頻率 每年息票付款的次數。 若為每年給付一次,frequency = 1;若為每半年給付一次,frequency = 2;若為每季給付一次,frequency = 4。
basis (選擇性) 要使用的天數計算基礎類型。 如果省略 basis,則會假設為 0。 接受的值會列在此資料表下方。

basis 參數接受下列值:

Basis 天數計算基準
0 或省略 US (NASD) 30/360
1 實際值/實際值
2 實際值/360
3 實際值/365
4 歐洲 30/360

傳回值

結算日期至到期日期之間的付息次數。

備註

  • 日期會以連續的序號來儲存,以便計算。 在 DAX 中,1899 年 12 月 30 日是第 0 天,而 2008 年 1 月 1 日因為是 1899 年 12 月 30 日之後的第 39,448 天,所以是第 39448 天。

  • 結算日是買方購買息票 (例如債券) 的日期。 到期日是息票到期的日期。 例如,假設 30 年的債券在 2008 年 1 月 1 日發行,而買方在六個月後購買此債券。 發行日期為 2008 年 1 月 1 日,結算日為 2008 年 7 月 1 日,而到期日則為發行日 2008 年 1 月 1 日之後 30 年,即 2038 年 1 月 1 日。

  • settlement 和 maturity 會取至整數。

  • frequency 和 basis 會四捨五入為最接近的整數。

  • 如果是下列情況,則會傳回錯誤:

    • settlement 或 maturity 不是有效的日期。
    • settlement ≥ maturity。
    • frequency 是 1、2 或 4 以外的任何數字。
    • basis < 0 或 basis > 4。
  • 在計算結果欄或資料列層級安全性 (RLS) 規則中使用時,不支援在 DirectQuery 模式中使用此函式。

範例

Data 說明
25-Jan-07 結算日期
15-Nov-08 到期日
2 半年度息票 (請參閱上文)
1 實際/實際基準 (請參閱上文)

下列 DAX 查詢:

EVALUATE
{
  COUPNUM(DATE(2007,1,25), DATE(2008,11,15), 2, 1)
}

傳回具有上述指定期間的債券息票付款數目。

[值]
4