文章

QuantLib 金融计算——天数计算规则详解

介绍 QuantLib 中的天数计算规则。

发表于
作者 徐瑞龙
12 分钟阅读

由于版本问题，代码可能与最新版不兼容。

天数计算规则详解

载入 QuantLib：

1
2
3

import QuantLib as ql

print(ql.__version__)

1

1.12

定义

  • Interest：一项投资产生的利息。
  • CouponFactor：在付息日支付票息时所需的折算因子，付息周期可以是完整或不完整的。
  • CouponRate：票息率。
  • Date1 (Y1.M1.D1)：前一付息日。
  • Date2 (Y2.M2.D2)：结算日。
  • Date3 (Y3.M3.D3)：后一付息日。
  • Days(StartDate, EndDate)：StartDate 和 EndDate 所差的天数（按照儒略历的规则计算）。
  • EOM：EOM 表示只在“月末”付息；非 EOM 表示在每月的同一天付息。
  • Factor：在计算利息时 CouponRate 的折算因子。通常表示为“应计期间的天数 / 所在年份的天数”，如果 Date2 是付息日，Factor 是零。
  • Freq：付息频率
    • 1 = 年付（annual）
    • 2 = 半年付（semi-annual）
    • 4 = 季付（quarterly）
    • 12 = 月付（monthly）
    • 以此类推
  • Principal：本金

利息的计算：

\[Interest = Principal \times CouponRate \times Factor\]

30 / 360 法

Factor 等于：

\[Factor = \frac{360 \times (Y_2- Y_1) + 30 \times (M_2 - M_1) + (D_2 - D_1)}{360}\]

CouponFactor 等于：

\[CouponFactor = \frac{360 \times (Y_3 - Y_1) + 30 \times (M_3 - M_1) + (D_3 - D_1)}{360}\]

这和 Factor 的计算相同，不过要把 Date2 换成 Date3。在这种情形下，如果碰到一个完整的付息周期，那么：

\[CouponFactor = \frac{1}{Freq}\]

将 Date1 和（或）Date2 调整至月末的习惯各不相同，进而形成了不同的约定，每一种约定都有一套调整方法。

规定一个月有 30 天，一年有 360 天极大的简化了日期计算。同时 360 是一个高度可分的数，半年度、季度和月度的付息频率分别对应 360 天中的 180、90 和 30，这意味着不同付息周期上的付息数量是一样的。

30/360 US

日期调整规则，注意，要严格按照下面的计算顺序：

  • 如果投资是 EOM 的，并且 Date1 是二月的最后一天，并且 Date2 是二月的最后一天，那么 D2 改为 30。
  • 如果投资是 EOM 的，并且 Date1 是二月的最后一天，那么 D1 改为 30。
  • 如果 D2 等于 31 并且 D1 等于 30 或 31，那么 D2 改为 30。
  • 如果 D1 等于 31，那么 D1 改为 30。

别名：

  • 30U/360
  • 30/360

QuantLib 实现：

  • ql.Thirty360(ql.Thirty360.USA)

30/360 Bond Basis

除了前两条外，该方法和 30U/360 一样。注意，要严格按照下面的计算顺序：

  • D1 = MIN (D1, 30).
  • If D1 = 30 Then D2 = MIN (D2,30)

别名：

  • 30A/360

QuantLib 实现：

  • ql.Thirty360(ql.Thirty360.BondBasis)

30E/360

日期调整规则：

  • 如果 D1 等于 31，那么 D1 改为 30。
  • 如果 D2 等于 31，那么 D2 改为 30。

别名：

  • 30/360 ICMA
  • 30S/360
  • Eurobond basis (ISDA 2006)
  • Special German

QuantLib 实现：

  • ql.Thirty360(ql.Thirty360.European)

30E/360 ISDA

日期调整规则：

  • 如果 D1 月末最后一天，那么 D1 改为 30。
  • 如果 D2 月末最后一天（除非 Date2 是到期日并且 M2 是二月），那么 D2 改为 30。

别名：

  • 30E/360 ISDA
  • Eurobond basis (ISDA 2000)
  • German

QuantLib 实现：

  • ql.Thirty360(ql.Thirty360.EurobondBasis)

Actual 法

该方法计算两个日期间的真实距离（遵循儒略历），也就是函数 Days(StartDate, EndDate)。该方法对一个具体的付息周期赋予 CouponRate 不同的折算因子。

Actual/Actual ICMA

公式：

\[Factor = \frac{Days(Date1,Date2)}{Freq \times Days(Date1,Date3)}\]

对于完整的付息周期，Date2 等于 Date3：

\[Factor = \frac{Days(Date1,Date3)}{Freq \times Days(Date1,Date3)} = \frac{1}{Freq}\]

对于不完整的付息周期，付息周期要被分解为一个或几个“拟付息周期”以便对应上付息日的频率。利息在每一个子周期上计算，再根据拟付息周期的个数相加得到总的利息。

该方法确保每次所支付的利息是同等的。

该方法同时确保一个付息周期里每一天都被同等赋值。然而付息周期可能有不同的长度，例如某年 365 天，按照半年一次的频率付息，那么一个付息周期是 182 天，另一个是 183 天。在这种情况下，第一个周期里每天被赋予 1/182 份的利息；另一个被赋予 1/183 份的利息。

别名：

  • Actual/Actual
  • Act/Act ICMA
  • ISMA-99
  • Act/Act ISMA

QuantLib 实现：

  • ql.ActualActual(ql.ActualActual.ISMA)

Actual/Actual ISDA

公式：

\[Factor = \frac{\textit{Days not in leap year}}{365} + \frac{\textit{Days in leap year}}{366}\]

天数计算的规则遵循儒略历的法则，第一天计入付息周期，最后一天不计入。

CouponFactor 的计算使用相同的公式，不过要把 Date2 换成 Date3。通常，不同付息周期内支付的利息是不等量的，这取决于闰年和非闰年上分配的天数。公式可以应用到完整和不完整的付息周期上。

别名：

  • Actual/Actual
  • Act/Act
  • Actual/365
  • Act/365

QuantLib 实现：

  • ql.ActualActual(ql.ActualActual.ISDA)

Actual/365 Fixed

公式：

\[Factor = \frac{Days(Date1,Date2)}{365}\]

每个月都不作特殊对待，并且假定一年只有 365 天。例如，一个周期始于 2005-02-01，结束于 2005-04-01，那么 Factor 等于 59 天 除以 365 天。

CouponFactor 使用相同的公式，不过要把 Date2 换成 Date3。通常，不同付息周期内支付的利息是不等量的，这取决于作为分子的天数。公式可以应用到完整和不完整的付息周期上。

别名：

  • Act/365 Fixed
  • A/365 Fixed
  • A/365F
  • English

QuantLib 实现：

  • ql.Actual365Fixed(ql.Actual365Fixed.Standard)

Actual/360

公式：

\[Factor = \frac{Days(Date1,Date2)}{360}\]

该方法用于货币市场上的短期借贷。每个月都不作特殊对待，并且假定一年只有 360 天。例如，一个周期始于 2005-02-01，结束于 2005-04-01，那么 Factor 等于 59 天 除以 360 天。

CouponFactor 使用相同的公式，不过要把 Date2 换成 Date3。通常，不同付息周期内支付的利息是不等量的，这取决于作为分子的天数。公式可以应用到完整和不完整的付息周期上。

别名：

  • Act/360
  • A/360
  • French

QuantLib 实现：

  • ql.Actual360()

Actual/364

公式：

\[Factor = \frac{Days(Date1,Date2)}{364}\]

每个月都不作特殊对待，并且假定一年只有 364 天。例如，一个周期始于 2005-02-01，结束于 2005-04-01，那么 Factor 等于 59 天 除以 364 天。

CouponFactor 使用相同的公式，不过要把 Date2 换成 Date3。通常，不同付息周期内支付的利息是不等量的，这取决于作为分子的天数。公式可以应用到完整和不完整的付息周期上。

QuantLib 实现：

  • 没有实现

Actual/365L

这里，L 表示闰年。

公式：

\[Factor = \frac{Days(Date1,Date2)}{DiY}\]

确定 $DiY$ 的规则：

  • 如果 Freq 等于 1（年付）：
    • 如果 2 月 29 日在 Date1（排除在区间外）和 Date2（包含在区间内）之间，那么 $DiY = 366$，否则 $DiY = 365$。
  • 如果 Freq 不等于 1：
    • 如果 Date2 落在闰年，那么 $DiY = 366$，否则 $DiY = 365$。

CouponFactor 使用相同的公式，不过要把 Date2 换成 Date3。通常，不同付息周期内支付的利息是不等量的，这取决于作为分子的天数。公式可以应用到完整和不完整的付息周期上。

别名：

  • ISMA-Year

QuantLib 实现：

  • 没有实现

Actual/Actual AFB

公式：

\[Factor = \frac{Days(Date1,Date2)}{DiY}\]

$DiY$ 的确定：

如果 2 月 29 日在 Date1（排除在区间外）和 Date2（包含在区间内）之间，那么 $DiY = 366$，否则 $DiY = 365$。

如果 Date1 到 Date2 超过一年，计算将分成两部分：

  • 计算经历的整年的个数，从周期的最后一天向前计算；
  • 剩下的部分按照前述的规则计算。

例如，一个周期始于 1994-02-10 至 1997-06-30，分解如下：

  • 1994-06-30 到 1997-06-30 经历了 3 年；
  • 1994-02-10 到 1994-06-30 对应 140/365。

最终结果是 3 + 140/365.

该方法并没有规定向前推算年数的方法。ISDA 的推算法要求：如果周期最后一天是 2 月 28 日，完整的一年要截止到前一个 2 月 28 日，除非 2 月 29 日存在，如果存在 2 月 29 日也要计入在内。下面的表格举例显示了 ISDA 的推算法和一般推算习惯的异同：

周期ISDA 推算法一般推算习惯
2004-02-28 至 2008-02-273 + 365 / 3663 + 365 / 366
2004-02-28 至 2008-02-284 + 1 / 3664
2004-02-28 至 2008-02-294 + 1 / 3664 + 1 / 366

QuantLib 实现：

  • ql.ActualActual(ql.ActualActual.AFB)

1/1

该方法用于通胀挂钩产品，以 4 年为一个周期，将额外的一天平均分配到 4 年上，即每年 365.25 天。

QuantLib 实现：

  • ql.OneDayCounter()
QuantLib
本文由作者按照 CC BY 4.0 进行授权