【入门夯实】os.date星号t：日期表的字段读取与构造

学员常见误区

判断"今天是否周日"来触发周常任务，学员解析 os.date("%w") 的字符串再 tonumber——能跑但绕，字段一多全是字符串操作。os.date("*t") 直接返回日期表：year、month、day、hour、min、sec、wday（周几，1 为周日）、yday（年内第几天），字段即取即用。错误场景：

local w = tonumber(os.date("%w"))
if w == 0 then
    sendmsg(nil, 1, "周日双倍")
end

单字段尚可，要同时取年月日时分就得解析四五次。

正确姿势

*t 取整张日期表，字段直读；os.time 接收日期表反向构造时间戳。周常任务的规范写法。示例代码如下：

local t = os.date("*t")
if t.wday == 1 or t.wday == 7 then
    sendmsg(nil, 1, "周末双倍进行中")
end
local next = os.time({ year = t.year, month = t.month,
    day = t.day + 1, hour = 0 })

日期表的 day 加 1 超出月末时，os.time 会自动进位到下个月——跨月构造不用手算。示例代码如下：

print(t.yday)

yday 返回年内第几天，做"本年第 N 天"类活动判断直接可用。

引擎验证

三步验证：*t 的字段与系统日期逐项一致；构造 day 加 1 跨月的日期表，os.time 输出的时间戳落在下月 1 日；wday 与日历核对（1 周日到 7 周六）。

举一反三

判断月末末日：把 day 加 1 构造时间戳再 *t 回读，月份变化即今天为月末。示例代码如下：

local function isMonthEnd(t)
    local nxt = os.time({ year = t.year, month = t.month,
        day = t.day + 1, hour = 12 })
    return os.date("*t", nxt).month ~= t.month
end