COUPNUM

适用于:计算列计算表度量值视觉对象计算

返回结算日和到期日之间应付的息票数,舍入到最接近的整息票数。

语法

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

parameters

术语 定义
settlement 证券的结算日。 证券结算日是指在发行日之后,证券卖给购买者的日期。
maturity 证券的到期日。 到期日是指证券到期的日期。
frequency 每年支付息票的次数。 按年支付,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 日的序列号是 39448,这是因为它距 1899 年 12 月 30 日有 39,448 天。

  • 结算日是指购买者买入息票(如债券)的日期。 到期日是指息票到期的日期。 例如,假设在 2008 年 1 月 1 日发行的 30 年期债券,6 个月后被购买者买走。 那么发行日为 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 模式下使用此函数。

示例

数据 描述
2007 年 1 月 25 日 结算日
2008 年 11 月 15 日 到期日
2 半年息票(参见上文)
1 实际天数/实际天数(参见上文)

以下 DAX 查询:

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

对于符合上述条件的债券,返回支付息票的次数。

[值]
4