Lua接口/服务端/GetQuarterTime：修订间差异
来自天龙知识库
跳到导航跳到搜索
整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明 |
维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例 |
||
| （未显示2个用户的4个中间版本） | |||
| 第1行： | 第1行： | ||
__NOTOC__ | __NOTOC__ | ||
<div class="lua-reference | <div class="lua-reference"> | ||
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/通用与活动|通用与活动]] · [[Lua接口/服务端调用约定|调用约定]] | [[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/通用与活动|通用与活动]] · [[Lua接口/服务端调用约定|调用约定]] | ||
<div | <div class="lua-lead lua-rule">返回 15 分钟时间片编号。</div> | ||
== Lua 调用 == | == Lua 调用 == | ||
<pre | <pre>GetQuarterTime()</pre> | ||
服务端脚本中共出现 46 处调用，实参个数出现过：0 个（46 处）。 | |||
实现位于 <code>LuaFnTbl_Misc.h</code>。 | |||
== 参数 == | == 参数 == | ||
| 第12行： | 第16行： | ||
== 返回值 == | == 返回值 == | ||
返回 1 | 返回 1 个 number：天数编码 × 100 + 当天刻钟编号。天数编码 = （年份 − 2000）× 1000 + 年积日（`tm_yday`，0 起算）；当天刻钟编号 = 小时 × 4 + 分钟 ÷ 15 取整，取值范围 0–95。 | ||
== 脚本中的调用 == | |||
以下是服务端脚本里的真实调用点，按实参形态去重后列出 1 条。这些调用取自随包发布的脚本，可用于确认参数顺序与实际传入的值；它们不代表该写法在当前版本仍然有效。 | |||
<pre>-- event/caoyun/ecaoyun.lua | |||
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。
