3. QuantLib 核心对象入门
在固定收益定价中，真正决定结果正确性的往往不是复杂的模型，而是最底层的时间与利率表达。QuantLib 将“日期”“日历”“计息天数”“付息计划”“利率”抽象为独立对象，任何一条债券现金流、任何一条贴现曲线，最终都由这些基础组件拼装而成。本节先把这五个核心对象讲透，为后续曲线构建与债券定价打地基。
一、核心原理：为什么需要这些基础组件
金融计算与普通数值计算最大的区别在于“时间不是连续实数”。市场约定：计息要按实际天数、付息要避开节假日、不同市场用不同日历、不同利率类型有不同复利方式。QuantLib 的设计哲学是把这些约定显式对象化，让定价逻辑与市场惯例解耦。
- Date：表示一个具体日期，支持加减天数、月份、年份，是现金流的“时间坐标”。
- Calendar：定义哪些日子是节假日，决定付息日、结算日是否顺延。
- DayCounter：把两个日期之间的天数转换为“年化时间”，是贴现因子的指数。
- Schedule：按规则生成一串付息日，是债券、互换现金流的骨架。
- InterestRate：封装利率数值、计息方式与复利频率，负责生成贴现因子。
关键理解：Date 提供“点”，Schedule 提供“序列”，DayCounter 提供“长度”，InterestRate 提供“折现”，Calendar 提供“合法性校验”。五者组合，才构成一条可定价的现金流。
二、方法流程：从日期到现金流的构建链路
下面用一段可运行的 C++ 代码展示典型构建流程：先定义估值日与日历，再生成付息计划，最后用利率计算贴现因子。
#include <ql/quantlib.hpp>
using namespace QuantLib;
Date today(15, June, 2024);
Calendar cal = TARGET(); // 银行间市场常用日历
Date settle = cal.advance(today, 2, Days); // 结算日顺延
// 付息计划：每半年付息一次，实际/实际计息
Schedule sched(settle,
cal.advance(settle, 5, Years),
Period(Semiannual),
cal,
ModifiedFollowing,
ModifiedFollowing,
DateGeneration::Backward,
false);
DayCounter dc = ActualActual(ActualActual::ISDA);
InterestRate r(0.035, dc, Compounded, Semiannual);
for (const auto& d : sched) {
Time t = dc.yearFraction(settle, d);
DiscountFactor df = r.discountFactor(t);
std::cout << d << " t=" << t << " df=" << df << std::endl;
}这段代码体现了标准链路：Calendar 校验并顺延日期 → Schedule 生成付息序列 → DayCounter 计算年化时间 → InterestRate 生成贴现因子。任何一步选错，最终价格都会偏离市场。
三、案例场景：一只 5 年期国债的组件选择
假设我们要为一只中国银行间市场 5 年期国债定价，估值日为 2024-06-15，票面利率 3.5%，半年付息。各组件选择如下：
| 组件 | 选择 | 理由 |
|---|---|---|
| Calendar | China(China::IB) | 银行间市场节假日规则 |
| DayCounter | ActualActual(ISDA) | 国债常用实际/实际 |
| Schedule 频率 | Semiannual | 半年付息一次 |
| BusinessDayConvention | ModifiedFollowing | 顺延但不跨月 |
| DateGeneration | Backward | 从到期日倒推付息日 |
| InterestRate | Compounded, Semiannual | 与付息频率一致 |
若把 DayCounter 换成 Thirty360，同样现金流下年化时间会变化，贴现因子随之改变，价格可能偏离数十个基点。这说明基础组件不是“可随意替换的细节”，而是定价结果的一部分。
四、误区与复盘
常见误区一：忽略 Calendar 的顺延规则。若付息日恰逢周末，未做 ModifiedFollowing 会导致现金流日期错误，进而影响计息天数与贴现。
常见误区二：DayCounter 与 InterestRate 的复利频率不匹配。例如用 Actual360 搭配 Annual 复利，却按半年付息，会导致贴现因子系统性偏差。
复盘建议：每次定价前，先打印 Schedule 的全部日期与对应 yearFraction，再核对 InterestRate 的复利方式。把“日期—天数—贴现”三步显式检查，能拦截绝大多数基础组件错误。
掌握这五个对象后，后续的收益率曲线构建、债券定价、久期计算都只是它们的组合应用。建议在练习中刻意替换 Calendar、DayCounter 与复利频率，观察价格变化，建立对市场惯例的直觉。