Lua接口/服务端/GetQuarterTime

来自雪舞天龙知识库
Waylee​(留言 | 贡献)2026年10月27日 (二) 12:39的版本 (维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航跳到搜索

首页 · 服务端接口 · 通用与活动 · 调用约定

返回 15 分钟时间片编号。

Lua 调用

GetQuarterTime()

服务端脚本中共出现 46 处调用,实参个数出现过:0 个(46 处)。

实现位于 LuaFnTbl_Misc.h。

参数

当前实现不读取固定位置的 Lua 参数。

返回值

返回 1 个 number:天数编码 × 100 + 当天刻钟编号。天数编码 = (年份 − 2000)× 1000 + 年积日(`tm_yday`,0 起算);当天刻钟编号 = 小时 × 4 + 分钟 ÷ 15 取整,取值范围 0–95。

调用示例

以下取自随包服务端脚本的真实调用,可对照上方参数表确认参数顺序:

-- event/caoyun/ecaoyun.lua
GetQuarterTime()

注意事项

  • 与 GetHourTime 不能混用:天数基准不同(本接口是「年份 + 年积日」日历编码,另一个是自 2007-01-01 起的绝对天数)。
  • 编号取自服务端本机时间(实现体先调用 `SetTime()`)。
  • 自动推导出的「固定返回组合包括 -1」来自函数尾部的兜底返回宏,不代表本接口会返回 -1。