Lua接口/服务端/GetQuarterTime：修订间差异
来自天龙知识库
跳到导航跳到搜索
维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例 |
维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例 |
||
| 第10行： | 第10行： | ||
服务端脚本中共出现 46 处调用，实参个数出现过：0 个（46 处）。 | 服务端脚本中共出现 46 处调用，实参个数出现过：0 个（46 处）。 | ||
实现位于 <code>LuaFnTbl_Misc.h</code> | 实现位于 <code>LuaFnTbl_Misc.h</code>。 | ||
== 参数 == | == 参数 == | ||
| 第16行： | 第16行： | ||
== 返回值 == | == 返回值 == | ||
返回 1 | 返回 1 个 number：天数编码 × 100 + 当天刻钟编号。天数编码 = （年份 − 2000）× 1000 + 年积日（`tm_yday`，0 起算）；当天刻钟编号 = 小时 × 4 + 分钟 ÷ 15 取整，取值范围 0–95。 | ||
== 脚本中的调用 == | == 脚本中的调用 == | ||
| 第22行： | 第22行： | ||
<pre>-- event/caoyun/ecaoyun.lua | <pre>-- event/caoyun/ecaoyun.lua | ||
GetQuarterTime()</pre> | GetQuarterTime()</pre> | ||
== 注意事项 == | |||
* **与 [[Lua接口/服务端/GetHourTime|GetHourTime]] 不能混用**：天数基准不同（本接口是「年份 + 年积日」日历编码，另一个是自 2007-01-01 起的绝对天数）。 | |||
* 编号取自服务端本机时间（实现体先调用 `SetTime()`）。 | |||
* 自动推导出的「固定返回组合包括 -1」来自函数尾部的兜底返回宏，不代表本接口会返回 -1。 | |||
</div> | </div> | ||
2026年9月20日 (日) 00:15的最新版本
返回 15 分钟时间片编号。
Lua 调用
GetQuarterTime()
服务端脚本中共出现 46 处调用，实参个数出现过：0 个（46 处）。
实现位于 LuaFnTbl_Misc.h。
参数
当前实现不读取固定位置的 Lua 参数。
返回值
返回 1 个 number：天数编码 × 100 + 当天刻钟编号。天数编码 = （年份 − 2000）× 1000 + 年积日（`tm_yday`，0 起算）；当天刻钟编号 = 小时 × 4 + 分钟 ÷ 15 取整，取值范围 0–95。
脚本中的调用
以下是服务端脚本里的真实调用点，按实参形态去重后列出 1 条。这些调用取自随包发布的脚本，可用于确认参数顺序与实际传入的值；它们不代表该写法在当前版本仍然有效。
-- event/caoyun/ecaoyun.lua GetQuarterTime()
注意事项
- **与 GetHourTime 不能混用**：天数基准不同（本接口是「年份 + 年积日」日历编码，另一个是自 2007-01-01 起的绝对天数）。
- 编号取自服务端本机时间（实现体先调用 `SetTime()`）。
- 自动推导出的「固定返回组合包括 -1」来自函数尾部的兜底返回宏，不代表本接口会返回 -1。
