项目	内容
文档类型	PHP 类方法
方法标识	`common::calculate_natural_month_due_time`
所属业务	公共接口
来源模块/系统	公共函数

功能说明

计算自然月预付费的到期时间

调用示例

$startTime = 1752984000;
$cycleTime = 1752984000;
$result = calculate_natural_month_due_time($startTime, $cycleTime);

参数	类型	必填	默认值	校验规则	说明
`startTime`	`int`	是	—	require	开始时间戳
`cycleTime`	`int`	是	—	require	周期时长(1=月,3=季,12=年)

返回项	类型	说明
`到期时间戳(下一个周期的1号零点)`	`int`	—

{
  "到期时间戳(下一个周期的1号零点)": 1
}

异常类型	说明
`Throwable`	调用失败时由具体实现抛出异常，异常信息以运行时结果为准。

获取请求头的jwt

智简魔方业务系统公共函数 common::get_header_jwt 用于从当前请求头读取 JWT。无需额外参数；返回请求头中的 JWT 字符串，适合二次开发、模块集成和调用结果核验。

计算计费时长

使用智简魔方业务系统公共函数 common::cal_billing_time 可根据开始和结束时间计算计费时长。需提供开始时间和结束时间；返回计算得到的计费时长，便于二次开发时复用处理结果并完成联调。