架构与系统设计 / 系统课时
结算周期设计
结算周期设计
结算周期设计要回答两个问题:一笔交易何时进入结算批次,以及遇到周末、节假日和截止时间后应顺延到哪一天。本课将把实时、T+1、T+2 等规则整理成可落库、可计算、可验证的统一模型。
学习目标
- 区分实时结算、自然日结算和工作日结算的适用边界
- 设计包含截止时间、时区与节假日顺延的结算规则
- 编写并验证一个可运行的结算日期计算器
先统一结算口径
实时结算通常表示交易成功后立即发起资金划拨,但不等于资金一定即时到账;银行处理窗口、风控审核和账户状态仍可能造成延迟。日结则先按账务日归集交易,再在指定日期生成结算批次。
企业支付平台应明确使用自然日还是工作日。T+1 若按自然日计算,周五交易可在周六结算;若按工作日计算,则需要跳过周末和配置的法定节假日。规则名称相同而口径不同,是最常见的结算争议来源。
| 周期 | 典型含义 | 适用场景 |
|---|---|---|
| 实时 | 交易成功后立即尝试出款 | 高时效、低风险商户 |
| T+1 | 交易账务日后的第 1 个有效结算日 | 常规商户日结 |
| T+2 | 交易账务日后的第 2 个有效结算日 | 需延迟核验或渠道到账较慢 |
从交易时间推导结算日
计算顺序应固定为:先把交易时间转换到商户或结算主体的时区,再判断是否超过日切截止时间,然后确定账务日,最后叠加周期并跳过不可结算日。节假日表应按国家或地区、币种、通道维度维护,避免所有业务共用一张简单日期表。

规则配置至少应包含 cycleType、businessDayOnly、cutoffTime、zoneId 和节假日日历标识。实时周期可以返回当前账务日;延迟周期则逐日递增,只在有效工作日减少剩余天数。
实现结算日期计算器
下面示例使用固定日期演示工作日顺延。示例中的 2026 年 10 月 12 日被配置为假日,因此 10 月 9 日周五的 T+1 结算日会顺延到 10 月 13 日周二。
import java.time.DayOfWeek;
import java.time.LocalDate;
import java.util.Set;
public class SettlementCycleDemo {
enum Cycle {
REAL_TIME, T1, T2
}
static LocalDate calculate(
LocalDate accountingDate,
Cycle cycle,
Set<LocalDate> holidays) {
int remainingDays = switch (cycle) {
case REAL_TIME -> 0;
case T1 -> 1;
case T2 -> 2;
};
LocalDate result = accountingDate;
while (remainingDays > 0) {
result = result.plusDays(1);
// 只有有效工作日才消耗一个结算周期天数
if (isBusinessDay(result, holidays)) {
remainingDays--;
}
}
return result;
}
static boolean isBusinessDay(
LocalDate date,
Set<LocalDate> holidays) {
DayOfWeek day = date.getDayOfWeek();
boolean weekend = day == DayOfWeek.SATURDAY
|| day == DayOfWeek.SUNDAY;
return !weekend && !holidays.contains(date);
}
public static void main(String[] args) {
LocalDate accountingDate = LocalDate.of(2026, 10, 9);
Set<LocalDate> holidays = Set.of(
LocalDate.of(2026, 10, 12)
);
for (Cycle cycle : Cycle.values()) {
System.out.println(
cycle + "=" + calculate(accountingDate, cycle, holidays)
);
}
}
}预期输出
REAL_TIME=2026-10-09
T1=2026-10-13
T2=2026-10-14生产实现还应先根据交易时间和截止时间计算 accountingDate。例如日切时间为 23:00,交易在当地时间 23:15 成功,则账务日通常归入次日,再从次日开始计算 T+N。
验收规则与关键边界
测试时至少覆盖日切前后、周五交易、连续节假日、跨年、闰日和时区切换。规则变更不能直接覆盖历史配置,应保存版本号和生效时间,使旧交易继续使用下单或入账时绑定的规则版本。
结算任务应以“商户、币种、结算日、规则版本”作为批次维度,并通过唯一约束防止重复建批。若节假日配置临时调整,只重算尚未锁定的批次,已出款批次不得回滚日期。